Ese número de comprobante ya existe

409number_already_used

Qué significa

La petición fijó un number que ya tiene otro comprobante de esa serie. No se emitió nada.

No reintentes la misma petición: fallará igual hasta que cambie lo que se indica abajo.

Por qué ocurre

• Tu sistema lleva su propio correlativo y repitió un número, o dos procesos tomaron el mismo.
• Se reintentó una emisión con number y sin Idempotency-Key: la primera sí se había creado.

Cómo resolverlo

1. Omite number: Emitay asigna el siguiente de la serie, sin huecos ni repeticiones.
2. Si el número lo decide tu sistema, envía también una Idempotency-Key: repetir la petición devuelve el comprobante que ya existe en lugar de este error.
3. Para ver qué comprobante tiene ese número: GET /v1/documents?series=F001&number=123.

Cómo llega

La respuesta es application/problem+json con estado 409, y su campo type es la dirección de esta página.Lo de abajo es lo que respondió la API a una petición que provoca este error.

{
  "type": "https://docs.emitay.com/errors/number_already_used",
  "title": "Ese número de comprobante ya existe",
  "status": 409,
  "detail": "F001-1 ya existe: ese número de la serie ya se usó. Omite number para tomar el siguiente",
  "errors": [
    {
      "field": "number",
      "message": "F001-1 ya existe: ese número de la serie ya se usó. Omite number para tomar el siguiente"
    }
  ]
}

Toda respuesta lleva además la cabecera Request-Id (req_…): cítala al pedir soporte.

Sigue con: Idempotencia · todos los errores