Boleta

La API de Facturación de Tandia te permite enviar boletas electrónicas.

Enviar una Boleta

Para enviar una boleta, realiza una solicitud POST a la siguiente url:

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

{
  "number": "BB02-00007034",
  "date": "2023-11-09T14:01:00-05:00",
  "company": {
    "tax_id": "ruc-registrada-en-api"
  },
  "currency": "PEN",
  "payment_method": "cash",
  "tax_total": 18.00,
  "sale_value": 100.00,
  "subtotal": 118.00,
  "total": 118.00,
  "taxed_amount": 100.00,
  "tax_amounts": [
    {
      "code": "IGV",
      "amount": 18.00
    }
  ],
  "items": [
    {
      "free": false,
      "code": "P001",
      "unit": "NIU",
      "description": "Producto 001",
      "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 boleta 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_47fa362e3f094ba99602cd6bc3a91ff8",
  "type": "receipt",
  "currency": "PEN",
  "external_id": null,
  "number": "BB02-00007034",
  "date": "2023-11-09T14:01: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": 118,
  "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": []
}