Novedades
Back to All

[API FE PAN] – Respuesta de la API

7 months ago by Alanube

Hemos trabajado en una serie de mejoras y ajustes para nuestra API de facturación electrónica, las cuales tendrán un impacto positivo en los tiempos de respuesta y la información que devolvemos junto a la emisión. A continuación, te presentamos algunas de las novedades más destacadas:

  • Ahora la primera respuesta incluye el XML contenedor con la información del documento emitido y la autorización de uso del PAC, para que puedas acceder rápidamente a toda la información necesaria.
  • También hemos mejorado la experiencia de usuario al informarte inmediatamente si un documento es rechazado debido a que no cumple con las validaciones del PAC.
  • Además, hemos añadido información relevante para el emisor en la respuesta inmediata, para que puedas tener una visión completa de la transacción y tomar decisiones informadas de manera rápida y eficiente.

XML contenedor incluido en la primera respuesta para una emisión exitosa

En línea con las regulaciones de los Proveedores Autorizados de Certificación (PAC), hemos actualizado nuestra API para que los emisores puedan acceder a un XML que contenga toda la información del documento emitido y la autorización de uso del PAC. Para obtener acceso a este XML, la API devolverá un enlace de descarga en la propiedad xml que se puede utilizar para descargar el archivo.

<?xml version="1.0" encoding="UTF-8"?>
<rContFe>
	<dVerForm>1.00</dVerForm>
  <xFe>
  	...Información relacionada al documento
  </xFe>
  <xProtFe>
  	...Protocolo de autorizacion de PAC
  </xProtFe>
  <xContEv>
  	...Eventos asociados
  </xContEv>
</rContFe>

Respuesta inmediata en caso de rechazo de documentos y éxito en las validaciones del PAC

En caso de que la información enviada sea inválida, el API devolverá una respuesta de error con httpStatusCode 400. Por otro lado, si la información es correcta y el documento se emite con éxito, recibirás una respuesta con httpStatusCode 201.

Ejemplo de una respuesta exitosa

{
    "message": "Document created",
    "document": {
        "id": "01GWT6ZWYJ2WPPRD2RH7F8D5J2",
        "stampDate": "2023-03-30T16:32:44-05:00",
        "status": "PROCESSED",
        "legalStatus": "PAC_AUTHORIZED",
        "company": "ALANUBE SOLUCIONES, S.A.",
        "cufe": "FE0420000155709117-2-2021-200000202303300068020012000014",
        "authorizationProtocol": "0000155709116-2-202120230000000000000089",
        "xml": "http://localhost:0000/api-alanube/document.xml?crentials",
        "response": [
            {
                "code": "0260",
                "message": "Autorizado el uso de la FE"
            }
        ],
        "qr": "https://dgi-fep.mef.gob.pa/Consultas/FacturasPorQR?chFE=FE0420"
    }
}

Ejemplo de una respuesta rechazada

{
    "errors": [
        {
            "code": "1750",
            "message": "Dígitos verificadores informados no corresponden al valor correcto"
        }
    ]
}

Información relevante del emisor añadida

En la respuesta inmediata del API, se incluyen dos propiedades adicionales: qr, que contiene el enlace para visualizar el documento en la página web de la DGI, legalStatus informando que el PAC autorizo el documento y response que contiene la respuesta del PAC. Estas propiedades brindan información importante para el emisor del documento.