[API FE PAN] Mejoras en respuesta validaciones notas crédito/débito

Nuevos Códigos de Error para Notas de Crédito/Débito

Al momento de crear una nota crédito o una nota débito se realizan validaciones en los documentos que estan referenciando las notas (las facturas). Se agregan nuevos códigos de errores en la respuesta (observar la ultima sección en la tabla de errores) y se mejora el formato.

Estructura de Respuesta de Error

Cuando ocurre un error de validación, la respuesta sigue este formato:

{
    "errors": [
        {
            "code": "AP13002",
            "message": "The referenced document is not authorized by DGI. Only DGI-authorized documents can be referenced",
            "document": {
                "emissionType": "CUFE",
                "cufeIdentification": "FE01XXXXXXX-2-2021-XXXXX"
            }
        },
        {
            "code": "AP11001",
            "message": "The referenced document was issued by a different PAC and could not be found in the DGI records. Please verify the document details.",
            "document": {
                "emissionType": "CUFE",
                "cufeIdentification": "FE01XXXXXXX-2-2021-XXXXX"
            }
        },
        {
            "code": "AP13005",
            "message": "The referenced document has an issue date that is after the issue date of this credit/debit note. Please check the dates and try again.",
            "document": {
                "emissionType": "ID",
                "apiIdentification": "01JXXXXXXXXXXXXXXXX"
            }
        }
    ]
}

Como se puede observar regresamos la información del documento referenciado que falló la validación en el formato que fue enviado, CUFE o ID de la API.

Tipos de Errores Agregados

Los nuevos códigos cubren validaciones para:

Documentos Externos (Emitidos con otro PAC)

• AP11001: Documento no encontrado en registros de la DGI.
• AP11002: Emisor del documento referenciado no coincide.
• AP11003: Receptor del documento referenciado no coincide.
• AP11004: Fecha de emisión del documento referenciado es futura.

Documentos Físicos (Tipo papel o impresos)

• AP12001: Faltan propiedades requeridas (issueDate, otherIdentification, emissionType).

Documentos Internos

• AP13001: Documento interno no encontrado.
• AP13002: Documento no autorizado por la DGI.
• AP13003: Documento cancelado.
• AP13004: Receptor no coincide.
• AP13005: Fecha de emisión inválida.
• AP13006: Identificador de documento faltante.

Validaciones Generales (GENERAL)

• AP14001: Documentos referenciados son de tipos diferentes (electrónicos vs. físicos).

Recomendaciones

• Verifique que los documentos referenciados cumplan con las validaciones antes de enviar la solicitud.
• Consulte la documentación para más información.