Notas de crédito

Envia una nota de crédito por email al cliente

post/sales/credit-notes/{id}/send-email

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/{id}/send-email
  • Auth: none declared

Path parameters

idstring required

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

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.