Percepciones

Emite una percepción

post/sales/perceptions

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/perceptions
  • Auth: none declared

Request body

issue_datestring required

Fecha de emisión en formato Epoch.

seriesstring required

Serie del documento

sequencestring required

Secuencia numérica del documento.

currencystring required

Código ISO 4217 de la moneda.

recipient_legal_namestring required

Nombre del cliente.

recipient_tax_idstring required

Identificación tributaria del cliente.

recipient_tax_id_typestring required

Tipo de identificación tributaria del cliente.

recipient_emailstring

Email del cliente al cual Dátil envía notificaciones sobre la factura. Si no lo envías, Dátil no enviará ninguna notificación.

perception_regimestring required

Régimen de la percepción. Ver tabla de Regímenes de Percepción.

perception_ratestring required

Tasa de la percepción en formato de dos decimales.

notestring

Nota con información adicional para el documento.

totalstring required

Importe total percibido, en formato de doce posiciones numéricas con hasta dos decimales.

total_charged_amountstring required

Importe total cobrado, en formato de doce posiciones numéricas con hasta dos decimales.

charged_amount_currencystring required

Moneda del importe cobrado.

auto_advanceboolean

Indica si el documento debe avanzar automáticamente en el flujo de autorización. Por defecto es true.

Example request

{
  "issue_date": "1791394186",
  "series": "P001",
  "sequence": "1",
  "currency": "PEN",
  "recipient_legal_name": "Jose Mario",
  "recipient_tax_id": "20601595665",
  "recipient_tax_id_type": "pe-ruc",
  "recipient_email": "prueba@prueba.com",
  "recipient_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": "PE"
  },
  "vendor_address": {
    "line_1": "Calle A",
    "locality": "Lima",
    "administrative_district_level_1": "Miraflores",
    "administrative_district_level_2": "Lima",
    "tax_code": "0000",
    "country": "PE"
  },
  "perception_regime": "01",
  "perception_rate": "1.00",
  "note": "Nota sobre el documento",
  "total": "100.00",
  "total_charged_amount": "97.00",
  "charged_amount_currency": "USD",
  "line_items": [
    {
      "affected_document_type": "01",
      "affected_document_number": "F001-1",
      "affected_document_order": "1",
      "affected_document_issue_date": "2020-01-01",
      "affected_document_total_amount": "12323.02",
      "affected_document_currency": "PEN",
      "affected_document_charges": [
        {
          "date": "2020-01-03",
          "amount": "1223.22",
          "currency": "PEN"
        }
      ],
      "perception_amount": "10.02",
      "perception_currency": "PEN",
      "perception_date": "2020-02-02",
      "chargable_amount": "10.02",
      "chargable_amount_currency": "PEN",
      "exchange_rate_source_currency": "USD",
      "exchange_rate_target_currency": "PEN",
      "exchange_rate_calculation_rate": "3.00",
      "exchange_rate_date": "2020-02-02"
    }
  ],
  "custom_fields": [
    {
      "name": "Cedula del Pasajero",
      "value": "1234556",
      "code": "3001"
    }
  ],
  "notes": [
    {
      "text": "Documento tributario",
      "code": "2008"
    }
  ],
  "auto_advance": true
}

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.

issue_datestring date-time required

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

seriesstring required

Serie del documento.

numberstring required

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

sequencenumber double required

Secuencia numérica del documento.

environment'live' | 'test' required

Tipo de ambiente del documento.

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

status'draft' | 'active' | 'void' required

Estatus del documento

draft: Borrador active: Activo void: Anulado.

typestring required

Tipo de documento.

datil.rest-api.schemas/seriesstring required

Serie del documento

recipient_legal_namestring required

Nombre del cliente.

recipient_tax_idstring required

Identificación tributaria del cliente.

recipient_emailstring

Email del cliente al cual Dátil envía notificaciones sobre la factura. Si no lo envías, Dátil no enviará ninguna notificación.

vendor_legal_namestring required

Nombre legal del emisor.

vendor_commercial_namestring required

Nombre comercial del emisor.

vendor_tax_idstring required

Identificación tributaria del emisor.

perception_regimestring required

Régimen de la percepción. Ver tabla de Regímenes de Percepción.

perception_ratenumber double required

Tasa de la percepción en formato de dos decimales.

notestring

Nota con información adicional para el documento.

totalnumber double required

Importe total percibido, en formato de doce posiciones numéricas con hasta dos decimales.

total_in_wordsstring required

Total incluido impuestos y descuentos, en palabras.

total_charged_amountnumber double required

Importe total cobrado, en formato de doce posiciones numéricas con hasta dos decimales.

Example response

{
  "id": "81wxc0qk5cgz4a7z3550a3art3",
  "issue_date": "2026-10-07T17:29:46Z",
  "series": "P001",
  "number": "P001-1",
  "sequence": 1,
  "currency": {
    "code": "PEN",
    "name": "Soles Peruanos",
    "symbol": "S/."
  },
  "country": {
    "code": "PE",
    "name": "Perú"
  },
  "type": "pe/sales-perception-void-request",
  "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"
      }
    ]
  },
  "datil.rest-api.schemas/series": "R001",
  "recipient_legal_name": "Jose Mario",
  "recipient_tax_id": "20601595665",
  "recipient_tax_id_type": {
    "type": "pe-ruc",
    "code": "6",
    "name": "RUC"
  },
  "recipient_email": "prueba@prueba.com",
  "recipient_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ú"
    }
  },
  "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ú"
    }
  },
  "perception_regime": "01",
  "perception_rate": 1,
  "note": "Nota sobre el documento",
  "total": 100,
  "total_in_words": "Ciento dieciocho soles.",
  "total_charged_amount": 97,
  "charged_amount_currency": {
    "code": "PEN",
    "name": "Soles Peruanos",
    "symbol": "S/."
  },
  "line_items": [
    {
      "affected_document_type": "01",
      "affected_document_number": "P001-1",
      "affected_document_order": "1",
      "affected_document_issue_date": "2026-10-07T17:29:46Z",
      "affected_document_total_amount": 12323.02,
      "affected_document_currency": {
        "code": "PEN",
        "name": "Soles Peruanos",
        "symbol": "S/."
      },
      "affected_document_charges": [
        {
          "date": "2026-10-07T17:29:46Z",
          "amount": 1223.22,
          "currency": {
            "code": "PEN",
            "name": "Soles Peruanos",
            "symbol": "S/."
          }
        }
      ],
      "perception_amount": 10.02,
      "perception_currency": {
        "code": "PEN",
        "name": "Soles Peruanos",
        "symbol": "S/."
      },
      "perception_date": "2026-10-07T17:29:46Z",
      "chargable_amount": 10.02,
      "chargable_amount_currency": {
        "code": "PEN",
        "name": "Soles Peruanos",
        "symbol": "S/."
      },
      "exchange_rate_source_currency": {
        "code": "PEN",
        "name": "Soles Peruanos",
        "symbol": "S/."
      },
      "exchange_rate_target_currency": {
        "code": "PEN",
        "name": "Soles Peruanos",
        "symbol": "S/."
      },
      "exchange_rate_calculation_rate": 3,
      "exchange_rate_date": "2026-10-07T17:29:46Z"
    }
  ],
  "void_requests": [
    {
      "id": "81wxc0qk5cgz4a7z3550a3art3",
      "issue_date": "2026-10-07T17:29:46Z",
      "series": "F001",
      "number": "FC01-1",
      "currency": {
        "code": "PEN",
        "name": "Soles Peruanos",
        "symbol": "S/."
      },
      "country": {
        "code": "PE",
        "name": "Perú"
      },
      "type": "pe/purchase-retention-void-request",
      "recipient_legal_name": "Jose Mario",
      "recipient_tax_id": "20601595665",
      "recipient_tax_id_type": {
        "type": "pe-ruc",
        "code": "6",
        "name": "RUC"
      },
      "recipient_email": "prueba@prueba.com",
      "recipient_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ú"
        }
      },
      "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ú"
        }
      },
      "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"
          }
        ]
      },
      "voided_documents": [
        {
          "number": "R001-1",
          "series": "R001",
          "document_type": "01",
          "sequence": 1,
          "void_reason": "Anulación por error en la información."
        }
      ]
    }
  ],
  "custom_fields": [
    {
      "name": "Cedula del Pasajero",
      "value": "1234556",
      "code": "3001"
    }
  ],
  "notes": [
    {
      "text": "Documento tributario",
      "code": "2008"
    }
  ]
}

Changes

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