PT EN

Visitas ao local

URL base: $BUSINESS_API

O objecto

idstring · obrigatório
tenant_idstring · obrigatório
request_idstring · obrigatório
statusstring · obrigatório

um de scheduled, completed, cancelled

visit_datestring (date) · obrigatório
booked_bystring · obrigatório

um de consumer, staff

notesstring · opcional
outcomestring · opcional
quote_idstring · opcional
completed_atstring (date-time) · opcional
cancelled_atstring (date-time) · opcional
created_atstring (date-time) · obrigatório
updated_atstring (date-time) · obrigatório
O objecto
{
  "id": "sit_2ljUKXviQDVcG3dOWH1ysvVGYfL",
  "tenant_id": "ten_2ugFXIC316WXzGu1HGal90AxTA6",
  "request_id": "req_2JrY4JziCp1C0bFCSLb4M37qGNH",
  "status": "scheduled",
  "visit_date": "2026-11-19",
  "booked_by": "consumer",
  "notes": "Leitura confirmada no local.",
  "outcome": "outcome",
  "quote_id": "quo_26mh1wUlhIGz1c4BTWQl9M2dDyI",
  "completed_at": "2026-11-19T09:30:00Z",
  "cancelled_at": "2026-11-19T09:30:00Z",
  "created_at": "2026-11-19T09:30:00Z",
  "updated_at": "2026-11-19T09:30:00Z"
}

Registar o resultado de uma visita ao local

Registos

POST /site-visits/{id}/complete

With quote lines, the revised quote is issued from the outcome at once; otherwise the request awaits a quote.

Parâmetros

idstring · caminho · obrigatório

ID of the scheduled site visit in the caller's tenant to record as completed.

Corpo application/json

outcomestring · obrigatório
quoteobject · opcional
Mostrar atributos filhos
linesarray of object · obrigatório
Mostrar atributos filhos
charge_codestring · opcional

A price key from quote-prices; omit for a free line

descriptionstring · opcional
quantitynumber · opcional

Defaults to 1

unit_price_centsinteger (int64) · opcional

Overrides the tariff price (with a reason) or prices a free line

taxableboolean · opcional

Free lines only; defaults to true

adjustment_reasonstring · opcional
valid_untilstring (date) · opcional

Defaults to 30 days from today

notesstring · opcional
site_visit_idstring · opcional

The visit this quote follows

Devolve

200 Completed visit, with quote_id when a quote was issued

Mostrar atributos
idstring · obrigatório
tenant_idstring · obrigatório
request_idstring · obrigatório
statusstring · obrigatório

um de scheduled, completed, cancelled

visit_datestring (date) · obrigatório
booked_bystring · obrigatório

um de consumer, staff

notesstring · opcional
outcomestring · opcional
quote_idstring · opcional
completed_atstring (date-time) · opcional
cancelled_atstring (date-time) · opcional
created_atstring (date-time) · obrigatório
updated_atstring (date-time) · obrigatório

Erros 400 · 403 · 404

Permissões connections:write · Funções: admin, operations, owner

curl -X POST "$BUSINESS_API/site-visits/{id}/complete" \
  -H "Authorization: Bearer sk_test_..." \
  -H "Content-Type: application/json" \
  -d '{
  "outcome": "outcome",
  "quote": {
    "lines": [
      {
        "charge_code": "CHA-2026-000142",
        "description": "Leitura confirmada no local.",
        "quantity": 1,
        "unit_price_cents": 125000,
        "taxable": true,
        "adjustment_reason": "adjustment reason"
      }
    ],
    "valid_until": "2026-11-19",
    "notes": "Leitura confirmada no local.",
    "site_visit_id": "sit_2ljUKXviQDVcG3dOWH1ysvVGYfL"
  }
}'
Resposta 200
{
  "id": "sit_2ljUKXviQDVcG3dOWH1ysvVGYfL",
  "tenant_id": "ten_2ugFXIC316WXzGu1HGal90AxTA6",
  "request_id": "req_2JrY4JziCp1C0bFCSLb4M37qGNH",
  "status": "scheduled",
  "visit_date": "2026-11-19",
  "booked_by": "consumer",
  "notes": "Leitura confirmada no local.",
  "outcome": "outcome",
  "quote_id": "quo_26mh1wUlhIGz1c4BTWQl9M2dDyI",
  "completed_at": "2026-11-19T09:30:00Z",
  "cancelled_at": "2026-11-19T09:30:00Z",
  "created_at": "2026-11-19T09:30:00Z",
  "updated_at": "2026-11-19T09:30:00Z"
}

Cancelar uma visita ao local

Registos

POST /site-visits/{id}/cancel

Marks a scheduled site visit as cancelled and records when. If the request was waiting on this visit (status visit_scheduled), it returns to accepted when a connection already exists, or to submitted otherwise. A visit that is already completed or cancelled is rejected with 400, and a concurrent change to the visit returns 409; requires connections:write.

Parâmetros

idstring · caminho · obrigatório

ID of the scheduled site visit in the caller's tenant.

Devolve

200 Cancelled visit

Mostrar atributos
idstring · obrigatório
tenant_idstring · obrigatório
request_idstring · obrigatório
statusstring · obrigatório

um de scheduled, completed, cancelled

visit_datestring (date) · obrigatório
booked_bystring · obrigatório

um de consumer, staff

notesstring · opcional
outcomestring · opcional
quote_idstring · opcional
completed_atstring (date-time) · opcional
cancelled_atstring (date-time) · opcional
created_atstring (date-time) · obrigatório
updated_atstring (date-time) · obrigatório

Erros 400 · 403 · 404

Permissões connections:write · Funções: admin, operations, owner

curl -X POST "$BUSINESS_API/site-visits/{id}/cancel" \
  -H "Authorization: Bearer sk_test_..."
Resposta 200
{
  "id": "sit_2ljUKXviQDVcG3dOWH1ysvVGYfL",
  "tenant_id": "ten_2ugFXIC316WXzGu1HGal90AxTA6",
  "request_id": "req_2JrY4JziCp1C0bFCSLb4M37qGNH",
  "status": "scheduled",
  "visit_date": "2026-11-19",
  "booked_by": "consumer",
  "notes": "Leitura confirmada no local.",
  "outcome": "outcome",
  "quote_id": "quo_26mh1wUlhIGz1c4BTWQl9M2dDyI",
  "completed_at": "2026-11-19T09:30:00Z",
  "cancelled_at": "2026-11-19T09:30:00Z",
  "created_at": "2026-11-19T09:30:00Z",
  "updated_at": "2026-11-19T09:30:00Z"
}