Notas de crédito

Emite una nota de crédito

post/sales/credit-notes

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/credit-notes
  • 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.

customer_legal_namestring required

Nombre del cliente.

customer_tax_idstring required

Identificación tributaria del cliente.

customer_tax_id_typestring required

Tipo de identificación tributaria del cliente.

customer_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.

customer_telephonestring

Teléfono del cliente.

customer_codestring

Código de cliente.

subtotalstring required

Subtotal de la factura, sin incluir impuestos.

subtotal_discountstring

Descuento adicional del documento.

subtotal_discount_codestring

Código de tipo de descuento adicional.

taxstring required

Total de impuestos de la factura.

gratuitystring

Valor de propina.

totalstring required

Total incluido impuestos y descuentos.

notestring

Nota con información adicional para la factura.

credit_reason_codestring required

Código del tipo de nota de crédito. Ver Tipos de notas de crédito.

credit_reason_notestring required

Notas sobre la razón de la emisión del documento.

credit_reason_descriptionstring required

Descripción de la razón de la nota de crédito.

credited_document_typestring required

Código del tipo de documento afectado. Ver tipos de documento.

credited_document_numberstring required

Número del documento afectado. Ver Especificación de numeración.

credited_document_datestring

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

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": "F001",
  "sequence": "1",
  "currency": "PEN",
  "customer_legal_name": "Jose Mario",
  "customer_tax_id": "20601595665",
  "customer_tax_id_type": "pe-ruc",
  "customer_email": "prueba@prueba.com",
  "customer_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"
  },
  "customer_telephone": "1234567890",
  "customer_code": "1234",
  "vendor_address": {
    "line_1": "Calle A",
    "locality": "Lima",
    "administrative_district_level_1": "Miraflores",
    "administrative_district_level_2": "Lima",
    "tax_code": "0000",
    "country": "PE"
  },
  "line_items": [
    {
      "sku": "A001",
      "item_classification_code": "1234",
      "tariff_heading": "1234",
      "description": "Servicio ABC",
      "price_type_code": "01",
      "unit_of_measurement": "KG",
      "unit_code": "1",
      "tax_included_unit_price": "118.00",
      "unit_price": "100.00",
      "quantity": "1",
      "discount": "0.00",
      "subtotal_without_discount": "100.00",
      "subtotal": "100.00",
      "tax": "18.00",
      "total": "118.00",
      "tax_lines": [
        {
          "tax_rate": "pe-igv",
          "amount": "18.00",
          "taxable_amount": "100.00",
          "exemption_reason_code": "10"
        }
      ],
      "custom_fields": [
        {
          "name": "Cedula del Pasajero",
          "value": "1234556",
          "code": "3001"
        }
      ]
    }
  ],
  "tax_lines": [
    {
      "tax_rate": "pe-igv",
      "amount": "18.00",
      "taxable_amount": "100.00",
      "exemption_reason_code": "10"
    }
  ],
  "subtotal": "100.00",
  "subtotal_discount": "0.00",
  "subtotal_discount_code": "00",
  "tax": "18.00",
  "gratuity": "5.00",
  "total": "118.00",
  "note": "Gracias por tu compra.",
  "credit_reason_code": "01",
  "credit_reason_note": "01",
  "credit_reason_description": "Devolución del producto.",
  "credited_document_type": "01",
  "credited_document_number": "F001-2",
  "credited_document_date": "1791394186",
  "custom_fields": [
    {
      "name": "Cedula del Pasajero",
      "value": "1234556",
      "code": "3001"
    }
  ],
  "notes": [
    {
      "text": "Documento tributario",
      "code": "2008"
    }
  ],
  "payment_terms": [
    {
      "code": "Contado",
      "currency": "PEN",
      "amount": "100.00",
      "due_date": "2021-08-01",
      "description": "Pago a 90 días."
    }
  ],
  "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 de la factura en formato RFC3339.

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.

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

Estatus del documento

draft: Borrador active: Activo void: Anulado.

typestring required

Tipo de documento.

seriesstring required

Serie del documento

sequencenumber double required

Secuencia numérica del documento.

customer_legal_namestring required

Nombre del cliente.

customer_tax_idstring required

Identificación tributaria del cliente.

customer_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 vendedor.

vendor_commercial_namestring required

Nombre comercial del vendedor.

vendor_tax_idstring required

Identificación tributaria del vendedor.

subtotalnumber double required

Subtotal de la factura, sin incluir impuestos.

subtotal_discountnumber double

Descuento total de la línea.

subtotal_discount_codestring

Código de tipo de descuento adicional.

taxnumber double required

Total de impuestos de la factura.

gratuitynumber double

Valor de propina.

totalnumber double required

Total incluido impuestos y descuentos.

total_in_wordsstring required

Total incluido impuestos y descuentos, en palabras.

notestring

Nota con información adicional para la factura.

credit_reason_codestring required

Código del tipo de nota de crédito. Ver Tipos de notas de crédito.

credit_reason_notestring required

Notas sobre la razón de la emisión del documento.

credit_reason_descriptionstring required

Descripción de la razón de la nota de crédito.

credited_document_typestring required

Código del tipo de documento afectado. Ver tipos de documento.

credited_document_numberstring required

Número del documento afectado. Ver Especificación de numeración.

credited_document_datestring date-time

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

Example response

{
  "id": "81wxc0qk5cgz4a7z3550a3art3",
  "number": "F001-1",
  "currency": {
    "code": "PEN",
    "name": "Soles Peruanos",
    "symbol": "S/."
  },
  "country": {
    "code": "PE",
    "name": "Perú"
  },
  "type": "pe/sales-credit-note",
  "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"
      }
    ]
  },
  "series": "F001",
  "sequence": 1,
  "customer_legal_name": "Jose Mario",
  "customer_tax_id": "20601595665",
  "customer_tax_id_type": {
    "type": "pe-ruc",
    "code": "6",
    "name": "RUC"
  },
  "customer_email": "prueba@prueba.com",
  "customer_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ú"
    }
  },
  "line_items": [
    {
      "tax": 18,
      "tax_included_unit_price": 118,
      "unit_price": 100,
      "quantity": 1,
      "subtotal": 100,
      "subtotal_without_discount": 100,
      "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
          }
        }
      ],
      "sku": "A001",
      "item_classification_code": "1234",
      "tariff_heading": "1234",
      "description": "Servicio ABC",
      "price_type_code": "01",
      "unit_of_measurement": "KG",
      "unit_code": "1",
      "custom_fields": [
        {
          "name": "Cedula del Pasajero",
          "value": "1234556",
          "code": "3001"
        }
      ]
    }
  ],
  "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
      }
    }
  ],
  "subtotal": 100,
  "subtotal_discount_code": "00",
  "tax": 18,
  "gratuity": 5,
  "total": 118,
  "total_in_words": "Ciento dieciocho soles.",
  "note": "Gracias por tu compra.",
  "credit_reason_code": "01",
  "credit_reason_note": "01",
  "credit_reason_description": "Devolución del producto.",
  "credited_document_type": "01",
  "credited_document_number": "F001-2",
  "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/sales-credit-note",
      "customer_legal_name": "Jose Mario",
      "customer_tax_id": "20601595665",
      "customer_tax_id_type": {
        "type": "pe-ruc",
        "code": "6",
        "name": "RUC"
      },
      "customer_email": "prueba@prueba.com",
      "customer_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": "FC01-1",
          "series": "FC01",
          "document_type": "01",
          "sequence": 1,
          "void_reason": "Anulación por error en datos del comprador."
        }
      ]
    }
  ],
  "custom_fields": [
    {
      "name": "Cedula del Pasajero",
      "value": "1234556",
      "code": "3001"
    }
  ],
  "notes": [
    {
      "text": "Documento tributario",
      "code": "2008"
    }
  ],
  "payment_terms": [
    {
      "code": "Contado",
      "currency": {
        "code": "PEN",
        "name": "Soles Peruanos",
        "symbol": "S/."
      },
      "amount": 100,
      "due_date": "1791394186",
      "description": "Pago a 90 días."
    }
  ]
}

Changes

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