Cómo resolver el error API RESPONSE: "El campo 'base_amount' es requerido"

Guía de solución de problemas API DATAICO NÓMINA ELECTRÓNICA


Explicación del Error:

Este error ocurre porque el campo charges en la estructura del documento JSON se está enviando de manera incorrecta.

  • En lugar de ser un arreglo de objetos (estructura esperada), se envió como un objeto único.
  • Como resultado, el sistema no puede procesar correctamente las propiedades dentro de charges, como base_amount, y marca ese campo como faltante.

La estructura enviada por el cliente presenta un error:


  "charges": {
    "reason": "PROPINA",
    "base_amount": 1528.00,
    "discount": false
  }

Detalle (RESPONSE):

{

    "errors": [
        {
            "path": [
                "invoice",
                "charges",
                0,
                "base_amount"
            ],
            "error": "El campo es requerido"
        },
        {
            "path": [
                "invoice",
                "charges",
                1,
                "base_amount"
            ],
            "error": "El campo es requerido"
        },
        {
            "path": [
                "invoice",
                "charges",
                2,
                "base_amount"
            ],
            "error": "El campo es requerido"
        }
    ]
}
 

Pasos para Solucionar el Error

  1. Asegúrate de enviar charges como un arreglo de objetos (lista) y no como un objeto único.

  2. La estructura correcta debe ser la siguiente:

    json
    Copiar código
    "charges": [
    {
    "reason": "PROPINA",
    "base_amount": 15000,
    "discount": false
    }
    ]
    • charges: Es un arreglo (indicado por []) que contiene un objeto con las propiedades:
      • reason: Motivo del cargo (ej. "PROPINA").
      • base_amount: El monto base del cargo.
      • discount: Indica si hay un descuento aplicado (valor booleano: true o false).
  3. Una vez corregida la estructura, guarda los cambios y vuelve a enviar el documento JSON.

 

Pasos para solucionar el error:

Asegúrate de enviar "charges" como un arreglo con un objeto dentro de él, con las propiedades "reason", "base_amount" y "discount" correctamente definidas.


  "charges": [
    {
      "reason": "PROPINA",
      "base_amount": 15000,
      "discount": false
    }
  ]

📌  Nota Importante: 

Si deseas conocer la estructura completa de la factura con un cargo adicional o "propina", haz clic en el siguiente enlace:  

 

Recursos Adicionales


+  Guía de Solución de Problemas API DATAICO FACTURA ELECTRÓNICA 
Documentación Técnica de la API de DATAICO FACTURA ELECTRÓNICA
+  API DOCS Documentación Técnica de FE

 

 

small-logo