Operar

Reintentos

Cuándo reintentar, cómo esperar y cómo no duplicar ventas ni compras.

Qué no se reintenta

RespuestaPor qué
400La petición es inválida: repetirla da el mismo error. Corrígela.
403Falta permiso en el perfil de la llave: no cambia solo.
409Choca con un registro que ya existe: repetirla igual da el mismo 409. La salida depende del caso: ver Errores.
501 NOT_AVAILABLE_YETResponde igual mientras su insignia no cambie; ver Disponibilidad.

Qué sí se reintenta, con espera creciente

Los 5xx (salvo 501) y las fallas de red o de tiempo de espera se reintentan con espera creciente y un tope: por ejemplo 2, 4, 8 y 16 segundos, y después te detienes y alertas a una persona. Nunca reintentes en bucle sin límite.

Antes de reenviar una venta, consúltala

Si una venta falló por red o por tiempo de espera, puede haberse creado igual. Antes de reenviarla:

  1. Consulta las ventas con tu internalId (Consultar y conciliar).
  2. Si trae alguna que no esté en EMITIDA, usa esa (si trae varias, la primera: es la más reciente): no la reenvíes.
  3. Si no trae ninguna, reenvíala con el mismo internalId.
  4. Si todas las que trae están en EMITIDA, ese intento no llegó a presentarse al MH y no se presenta solo después. Espera unos segundos y consulta de nuevo, por si todavía está terminando; si sigue en EMITIDA, reenvíala con el mismo internalId: la API lo permite y la nueva pasa a ser la primera.

Así evitas documentos duplicados ante el MH. Si la venta que usas trae haciendaResponse en null, no la reenvíes: ver Contingencia.

Antes de reenviar una compra, consúltala

Una compra que falló por red o por tiempo de espera también puede haberse creado igual. Antes de reenviarla, consulta las compras con tu internalId (Consultar y conciliar):

  1. Si no trae ninguna, reenvíala con el mismo internalId.
  2. Si trae alguna, no la reenvíes: una compra con ese internalId, en cualquier estado, impide crear otra y reenviarla responde 409 sin code. Usa la primera (la lista va de la más reciente a la más antigua); si está en CONTINGENCIA, ver Contingencia.
  3. Si está en EMITIDA, espera unos segundos y consulta de nuevo, por si todavía está terminando. Si sigue en EMITIDA, no se presenta sola al MH: pide al equipo de Openbox Cloud que la revise, con su id.

No inicies sesión por cada petición

Cada inicio de sesión revoca los tokens anteriores (Autenticación). Reutiliza el token y vuelve a iniciar sesión una sola vez cuando recibas 401.

Copyright © 2026