Recetas
Consultar el estado ante el MH y conciliar
Consulta ventas y compras por el id de Openbox Cloud o por tu internalId, y concilia su estado con tu sistema.
Las consultas exigen que el perfil de tu llave tenga el módulo Facturación (ventas) o
Compras (compras); sin él responden 403 con No tienes acceso al modulo de <módulo>.
(Permisos por módulo).
Consultar una venta
| Operación | Insignia |
|---|---|
| Por id de Openbox Cloud | DisponibleGET /partners/v1/invoices/{id} Ver operación en la Referencia → |
Por internalId | DisponibleGET /partners/v1/invoices Ver operación en la Referencia → |
Terminal
curl "$OPENBOX_API_URL/partners/v1/invoices/<ID_DE_LA_VENTA>" \
-H 'Authorization: Bearer <TOKEN>'
La consulta por internalId devuelve todas las ventas con ese identificador, de la más
reciente a la más antigua.
Consultar una compra
| Operación | Insignia |
|---|---|
| Por id de Openbox Cloud | DisponibleGET /partners/v1/purchases/{id} Ver operación en la Referencia → |
Por internalId | DisponibleGET /partners/v1/purchases Ver operación en la Referencia → |
Terminal
curl "$OPENBOX_API_URL/partners/v1/purchases?internalId=CMP-0001" \
-H 'Authorization: Bearer <TOKEN>'
Conciliar con tu sistema
Conciliar es confirmar que cada documento de tu sistema tiene su par en Openbox Cloud, con el mismo estado ante el MH:
- Consulta por tu
internalIdcada venta o compra que tu sistema da por emitida. - Si la consulta no trae ninguna, el documento no se creó: revisa la respuesta que recibiste al enviarlo y, si fue una falla de red, sigue Reintentos.
- Si trae una, compara su
status(por ejemploEMITIDA,PRESENTADA,ANULADAoCONTINGENCIA; la Referencia lista todos) con el de tu sistema y guarda elidde Openbox Cloud si no lo tenías. - Si trae más de una, la primera es el último intento: concilia con ella. Las demás son intentos
anteriores con el mismo
internalId(por ejemplo, uno que quedóEMITIDA). Si la primera no coincide con el estado de tu sistema, revisa las demás porcreatedAtantes de darla por desconciliada. - Si la
haciendaResponsedel documento con el que concilias (la primera coincidencia, si trajo varias) viene ennull, el MH no ha respondido: ver Contingencia.
Un id que no existe
Así responde hoy la API, y así lo documentamos:
- Venta inexistente:
400. - Compra inexistente:
404.
Un id que no tiene la forma de un id de Openbox Cloud (8-4-4-4-12 hexadecimal) responde 400 en
las dos, sin llegar a buscar el documento.