Nota de débito

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

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.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-registrada-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": []
}