Nota de crédito

La API de Facturación de Tandia te permite enviar notas de crédito electrónicas.

Enviar una Nota de crédito

Para enviar una nota de crédito, realiza una solicitud POST a la siguiente URL:

POST /api/credit-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 crédito que deseas enviar. Aquí tienes un ejemplo de un cuerpo de solicitud:

{
  "number": "BC24-00100312",
  "date": "2023-11-09T20:46:00-05:00",
  "document_related_type": "receipt",
  "document_related_number": "BB40-00000147",
  "reason_code": "01",
  "reason": "ANULACION DE LA OPERACION",
  "company": {
    "tax_id": "ruc-registrada-en-api"
  },
  "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": []
}

Respuesta

Cuando envías una nota de crédito 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_283eb7ff4fe5458687dafa34c73388e7",
  "type": "credit-note",
  "currency": "PEN",
  "external_id": null,
  "number": "BC24-00100312",
  "date": "2023-11-09T20:46: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": [],
  "failure_code": null,
  "failure_message": null,
  "document_pdf": null,
  "document_file": null,
  "qr_code": null,
  "result": null,
  "logs": []
}