Faktur

GET /v1/documents/ride/:accessKey

Scope: documents:read

Obtiene el RIDE (PDF del comprobante). Solo disponible para documentos AUTHORIZED.

Parámetros

  • Path: accessKey — 49 dígitos.
  • Query opcional: format=base64 — devuelve JSON con el PDF en base64 en vez de binario.

Respuesta 200

Sin format=base64: binario application/pdf con Content-Disposition.

Con format=base64:

{
  "success": true,
  "data": {
    "pdfBase64": "JVBERi0x...",
    "filename": "ride-001-001-000000001.pdf"
  }
}

Errores

HTTPerror.codeCuándo
400INVALID_ACCESS_KEYClave no tiene 49 dígitos.
400DOCUMENT_NOT_FOUNDDocumento no encontrado.
400RIDE_NOT_AVAILABLEDocumento no está AUTHORIZED.
503RIDE_SERVICE_ERRORError en el servicio de generación de PDF.

GET /v1/documents/xml/:accessKey/:type

Scope: documents:read

Obtiene el XML del comprobante. Respuesta JSON con el XML como string y el nombre de archivo sugerido.

Parámetros

  • Path accessKey: clave de acceso (49 dígitos).
  • Path type: uno de unsigned, signed, authorized.

Respuesta 200

{
  "success": true,
  "data": {
    "xml": "<?xml version=\"1.0\"?>...",
    "filename": "001-001-000000001-authorized.xml"
  }
}

Errores

HTTPerror.codeCuándo
400INVALID_ACCESS_KEYClave distinta de 49 dígitos.
400INVALID_XML_TYPEtype no es unsigned, signed o authorized.
400DOCUMENT_NOT_FOUNDDocumento no encontrado.
400XML_NOT_AVAILABLEEse XML aún no está disponible para el documento.