No existe el recurso

404not_found

Qué significa

No existe lo que la petición nombra: un recurso con ese id para esta empresa y este modo, o una ruta con ese método.

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

Por qué ocurre

• El id es de un recurso del otro modo: un comprobante emitido con sk_test_… no existe para sk_live_…, y al revés.
• El id es de otra empresa, o está mal copiado. La respuesta es la misma en los tres casos: no dice qué ids existen.
• La ruta o el método no existen. En ese caso el detail los nombra.
• Se pidió un comprobante por la ruta con que se emite (GET /v1/invoices/{id}): todos se consultan en /v1/documents/{id}, sean del tipo que sean.
• Se pidió el CDR de un comprobante al que SUNAT aún no respondió.

Cómo resolverlo

1. Comprueba con qué llave se creó el recurso: npx emitay whoami dice la empresa y el modo de la que usas.
2. Para encontrar un comprobante por su número sin tener el id: GET /v1/documents?series=F001&number=123, o npx emitay document F001-123.
3. Si el detail nombra una ruta, compárala con la referencia de la API.

Cómo llega

La respuesta es application/problem+json con estado 404, 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/not_found",
  "title": "No existe el recurso",
  "status": 404,
  "detail": "No existe la ruta GET /v1/invoices/doc_01k7. Un comprobante se consulta en /v1/documents/doc_01k7, sea del tipo que sea"
}

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

Sigue con: Referencia de la API · todos los errores