Obtener XML público por CUF
/api/v1/public/facturas/:cuf/xmlDescarga el XML fiscal firmado almacenado para una factura identificada por CUF. No requiere X-API-Key; el CUF funciona como identificador público de consulta.
X-API-KeyVer operaciones de Documentos públicos Contrato de la operación
Descarga el XML fiscal firmado almacenado para una factura identificada por CUF. No requiere X-API-Key; el CUF funciona como identificador público de consulta.
cuf es el Código Único de Factura recibido al emitir. Responde 200 con application/xml; responde 404 si no encuentra la factura o corresponde a una factura histórica sin XML almacenado. La consulta comprueba la existencia del XML, pero no filtra por el estado fiscal actual: descargarlo no demuestra por sí solo que la factura siga aceptada o que SIAT haya confirmado su recepción. Consulta el estado fiscal por los endpoints de factura.
El XML contiene información fiscal del emisor y cliente. No añadas credenciales al enlace ni lo indexes como contenido público general.
Ejemplo de respuesta 404:
json
{
"type": "urn:facturador:problem:resource_not_found",
"title": "recurso no encontrado",
"status": 404,
"detail": "recurso no encontrado",
"instance": "/api/v1/public/facturas/CUF/xml",
"code": "resource_not_found"
}Ejemplo
Solicitud de ejemplo
export FALMUS_API_URL='https://staging-api.falmus.com/api/v1'
export FALMUS_API_KEY='flm_test_REEMPLAZA_CON_TU_CLAVE'
export CUF='REEMPLAZA_CON_CUF'
curl --request GET \
--url "$FALMUS_API_URL/public/facturas/${CUF}/xml" \
--header "X-API-Key: $FALMUS_API_KEY"Este ejemplo no incluye un cuerpo. Revisa el contrato para conocer los parámetros de ruta y consulta.
Respuesta
Ejemplo de respuesta
application/xml; charset=utf-8El cuerpo contiene el XML fiscal firmado. Con download=1 se entrega como archivo adjunto; en otro caso, se muestra en línea.
Datos ficticios; los identificadores y valores cambian en cada respuesta.