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ónInsignia
Por id de Openbox CloudDisponibleGET /partners/v1/invoices/{id} Ver operación en la Referencia →
Por internalIdDisponibleGET /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ónInsignia
Por id de Openbox CloudDisponibleGET /partners/v1/purchases/{id} Ver operación en la Referencia →
Por internalIdDisponibleGET /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:

  1. Consulta por tu internalId cada venta o compra que tu sistema da por emitida.
  2. 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.
  3. Si trae una, compara su status (por ejemplo EMITIDA, PRESENTADA, ANULADA o CONTINGENCIA; la Referencia lista todos) con el de tu sistema y guarda el id de Openbox Cloud si no lo tenías.
  4. 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 por createdAt antes de darla por desconciliada.
  5. Si la haciendaResponse del documento con el que concilias (la primera coincidencia, si trajo varias) viene en null, 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.

Copyright © 2026