Use updatedSince em sincronizações incrementais. Guarde IDs NGolaBooking como referência canónica e coloque IDs do ERP/POS em externalRefs.
| Recurso | Endpoint | Uso |
|---|---|---|
| Catálogo | GET /catalog | Restaurante, menu, mesas e stock. |
| Reservas | GET /bookings?updatedSince=… | Agenda, cliente, mesa, estado e valores. |
| Pedidos | GET /orders?updatedSince=… | Takeaway/pré-encomenda, itens e recolha. |
| Pagamentos | GET /payments?updatedSince=… | Liquidações, comissão e taxas. |
{
"version": "v1",
"requestId": "req_01J…",
"data": { "id": "bkg_32…", "code": "RES-3798", "status": "CONFIRMED", "guestCount": 4,
"amounts": { "deposit": 5000, "preorder": 0, "currency": "AOA" } }
}Paginação e sincronização
Comece por uma sincronização completa. Depois persista a última marca temporal bem-sucedida e envie-a em updatedSince. Trate respostas repetidas como normais: atualize pelo ID canónico, nunca crie um novo registo.