Nota de crédito

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

Cuándo usar una nota de crédito

Una nota de crédito (credit-note) disminuye o anula el efecto de una factura o boleta emitida previamente. Siempre debes indicar el comprobante relacionado 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 anulación de operación, 03 corrección por descripción, 04 descuento global, 05 descuento por ítem, 06 devolución total y 07 devolución por ítem.

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