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
| HTTP | error.code | Cuándo |
|---|---|---|
| 400 | INVALID_ACCESS_KEY | Clave no tiene 49 dígitos. |
| 400 | DOCUMENT_NOT_FOUND | Documento no encontrado. |
| 400 | RIDE_NOT_AVAILABLE | Documento no está AUTHORIZED. |
| 503 | RIDE_SERVICE_ERROR | Error 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 deunsigned,signed,authorized.
Respuesta 200
{
"success": true,
"data": {
"xml": "<?xml version=\"1.0\"?>...",
"filename": "001-001-000000001-authorized.xml"
}
} Errores
| HTTP | error.code | Cuándo |
|---|---|---|
| 400 | INVALID_ACCESS_KEY | Clave distinta de 49 dígitos. |
| 400 | INVALID_XML_TYPE | type no es unsigned, signed o authorized. |
| 400 | DOCUMENT_NOT_FOUND | Documento no encontrado. |
| 400 | XML_NOT_AVAILABLE | Ese XML aún no está disponible para el documento. |