Boletas

Anula una boleta

post/sales/receipts/{id}/void

Request

  • Base URL: https://api.datil.com (the document declares no server; this is the origin it was published from)
  • URL: https://api.datil.com/sales/receipts/{id}/void
  • Auth: none declared

Path parameters

idstring required

Identificador único del documento, generado por Dátil.

Request body

issue_datestring required

Fecha de emisión en formato Epoch o ISO 8601.

sequencestring required

Secuencia numérica del documento.

void_reasonstring required

Razón por la cual se anula el documento.

Example request

{
  "issue_date": "1791394186",
  "sequence": "1",
  "void_reason": "Error de facturación."
}

Response

OK

idstring required

Identificador único del documento, generado por Dátil. Te sugerimos guardarlo en tu base de datos para que luego puedas consultar su estado.

vendor_legal_namestring required

Nombre legal del vendedor.

vendor_commercial_namestring required

Nombre comercial del vendedor.

vendor_tax_idstring required

Identificación tributaria del vendedor.

issue_datestring date-time required

Fecha de emisión del documento, en formato RFC3339.

reference_datestring date-time required

Corresponde a la fecha de emisión de los documentos anulados.

seriesstring required

Serie del documento

sequencenumber double required

Secuencia numérica del documento.

numberstring required

Número de documento, generado en el siguiente formato: series-sequence

environment'live' | 'test' required

Tipo de ambiente del documento.

live: Ambiente de producción. test: Ambiente de pruebas.

typestring required
void_reasonstring required

Razón por la cual se anula el documento.

Example response

{
  "id": "81wxc0qk5cgz4a7z3550a3art3",
  "affected_documents": [
    {
      "series": "F001",
      "sequence": 1,
      "type_code": "01",
      "customer_tax_id_type": {
        "type": "pe-ruc",
        "code": "6",
        "name": "RUC"
      },
      "currency": {
        "code": "PEN",
        "name": "Soles Peruanos",
        "symbol": "S/."
      },
      "tax_lines": [
        {
          "exemption_reason_code": "10",
          "taxable_amount": 18,
          "amount": 18,
          "tax_rate": {
            "type": "pe-igv",
            "name": "IGV",
            "category-code": "VAT",
            "code": "1000",
            "percentage": 18
          }
        }
      ]
    }
  ],
  "vendor_legal_name": "Jose Mario",
  "vendor_commercial_name": "Jose Mario",
  "vendor_tax_id": "20601595665",
  "vendor_tax_id_type": {
    "type": "pe-ruc",
    "code": "6",
    "name": "RUC"
  },
  "vendor_address": {
    "line_1": "Calle A",
    "locality": "Lima",
    "administrative_district_level_1": "Miraflores",
    "administrative_district_level_2": "Lima",
    "city": "Lima",
    "province": "Lima",
    "tax_code": "0000",
    "country": {
      "code": "PE",
      "name": "Perú"
    }
  },
  "issue_date": "2026-10-07T17:29:46Z",
  "reference_date": "2026-10-07T17:29:46Z",
  "series": "RA-20201001",
  "sequence": 1,
  "number": "RA-20201001-1",
  "country": {
    "code": "PE",
    "name": "Perú"
  },
  "void_reason": "Error de facturación.",
  "tax_clearance": {
    "void_requests": [
      {
        "id": "81wxc0qk5cgz4a7z3550a3art3",
        "type": "pe/void-request",
        "series": "RA-20210315",
        "sequence": 1,
        "number": "RA-20210315-3",
        "tax_clearance": {
          "status": "cleared",
          "status_description": "ACEPTADO",
          "status_code": "0",
          "ticket": "1234567890",
          "date": "1791394186",
          "message": "El documento ha sido aceptado.",
          "ack_xml": "<xml></xml>",
          "qr_data": "20602224886|6|F002|F002-29|1800.00|11800.00|02/10/2020|6|20877294591|",
          "xml": "https://api.datil.com/documents/1234/xml",
          "pdf": "https://api.datil.com/p/1234",
          "warnings": [
            {
              "status_code": "0000",
              "message": "Documento de pruebas"
            }
          ]
        }
      }
    ],
    "status": "cleared",
    "status_description": "ACEPTADO",
    "status_code": "0",
    "ticket": "1234567890",
    "date": "1791394186",
    "message": "El documento ha sido aceptado.",
    "ack_xml": "<xml></xml>",
    "qr_data": "20602224886|6|F002|F002-29|1800.00|11800.00|02/10/2020|6|20877294591|",
    "xml": "https://api.datil.com/documents/1234/xml",
    "pdf": "https://api.datil.com/p/1234",
    "warnings": [
      {
        "status_code": "0000",
        "message": "Documento de pruebas"
      }
    ]
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.