Nota de débito

La API de Facturación de Tandia te permite enviar notas de débito electrónicas.

Cuándo usar una nota de débito

Una nota de débito (debit-note) incrementa el valor de una factura o boleta emitida previamente. Igual que la nota de crédito, debe referenciar el comprobante original con document_related_type y document_related_number.

Campos clave:

Campo	Descripción
document_related_type	Tipo del comprobante origen: invoice o receipt.
document_related_number	Número completo del comprobante origen.
reason_code	Código tributario del motivo de la nota.
reason	Descripción legible del motivo.

Motivos frecuentes: 01 intereses por mora, 02 aumento de valor y 03 penalidades u otros conceptos definidos por la operación.

Enviar una Nota de débito

Para enviar una nota de débito, realiza una solicitud POST a la siguiente URL:

POST /api/debit-note
Host: invoice.test.tandia.io
Content-Type: application/json
Authorization: Bearer token-de-api

Solicitud

Debes proporcionar un cuerpo de solicitud en formato JSON con la información de la nota de débito que deseas enviar. Aquí tienes un ejemplo de un cuerpo de solicitud:

{
  "number": "FD01-00001008",
  "date": "2023-11-09T19:44:00-05:00",
  "document_related_type":"invoice",
  "document_related_number": "FF41-00020402",
  "reason_code": "02",
  "reason": "AUMENTO DE VALOR",
  "company": {
    "tax_id": "ruc-registrado-en-api"
  },
  "customer": {
    "document_type": "6",
    "document_number": "20740021552",
    "registration_name": "John Doe SAC"
  },
  "currency": "PEN",
  "tax_total": 36.00,
  "sale_value": 200.00,
  "subtotal": 236.00,
  "total": 236.00,
  "taxed_amount": 200.00,
  "tax_amounts": [
    {
      "code": "IGV",
      "amount": 36.00
    }
  ],
  "items": [
    {
      "free": false,
      "code": "C01",
      "unit": "NIU",
      "description": "PRODUCTO 1",
      "quantity": 2.00,
      "unit_value": 50.00,
      "unit_price": 59.00,
      "tax_total": 18.00,
      "sale_value": 100.00,
      "subtotal": 100.00,
      "total": 118.00,
      "taxes": [
        {
          "code": "IGV",
          "amount": 18.00
        }
      ]
    },
    {
      "free": false,
      "code": "C02",
      "unit": "NIU",
      "description": "PRODUCTO 2",
      "quantity": 2.00,
      "unit_value": 50.00,
      "unit_price": 59.00,
      "tax_total": 18.00,
      "sale_value": 100.00,
      "subtotal": 100.00,
      "total": 118.00,
      "taxes": [
        {
          "code": "IGV",
          "amount": 18.00
        }
      ]
    }
  ],
  "legends": [],
  "metadata": {
    "comment": "Modifica a: FACTURA DE VENTA - FF01-76"
  }
}

Respuesta

Cuando envías una nota de débito a través de la API de Facturación de Tandia, recibirás una respuesta que contiene información sobre el estado del comprobante. A continuación, se detalla la estructura de la respuesta:

{
  "id": "doc_b927c80be8c74d289d8dbbe4096f7f66",
  "type": "debit-note",
  "currency": "PEN",
  "external_id": null,
  "number": "FD01-00001008",
  "date": "2023-11-09T19:44:00-05:00",
  "company": {
    "tax_id": "20750022128",
    "business_name": "Corp Demo S.A.C.",
    "trade_name": "Corp Demo",
    "email": "user@corp.com",
    "phone": "+51 987654321",
    "country": "PE",
    "address": {
      "postal_zone": "15074",
      "country": "PE",
      "country_subentity": "LIMA",
      "city": "LIMA",
      "district": "LIMA",
      "city_subdivision": null,
      "address": "CALLE MANUEL A. FUENTES NRO. 683 INT. 101",
      "type_code": null
    },
    "logo": null
  },
  "total": 236,
  "observation": null,
  "status": "created",
  "success": false,
  "metadata": {
    "comment": "Modifica a: FACTURA DE VENTA - FF01-76"
  },
  "failure_code": null,
  "failure_message": null,
  "document_pdf": null,
  "document_file": null,
  "qr_code": null,
  "result": null,
  "logs": []
}