Saltar al contenido
Krezkadev
POST/credit_notes

Emitir una nota de crédito

Modifica un comprobante ya aceptado. Para un comprobante de más de 7 días, la nota de crédito es la única forma de anularlo.

Cuerpo de la solicitud

issuer_idstringrequerido
affects_invoice_idstringrequerido

El comprobante que modifica. Debe estar accepted u observed.

reason_codeenumrequerido

Catálogo SUNAT 09. 01 anulación de la operación · 02 anulación por error en el RUC · 03 corrección por error en la descripción · 04 descuento global · 05 descuento por ítem · 06 devolución total · 07 devolución por ítem · 08 bonificación · 09 disminución en el valor · 10 otros conceptos · 11 ajustes de operaciones de exportación · 12 ajustes afectos al IVAP · 13 corrección del monto neto pendiente de pago.

01020304050607080910111213

descriptionstringrequerido

Sustento de la nota, en palabras.

seriesstring

Serie de nota (FC01 para facturas, BC01 para boletas). Por defecto, la del emisor.

itemsobject[]

Líneas de la nota. Si las omites en una anulación total (01, 06), se toman del comprobante afectado.

descriptionstringrequerido
product_codestring

Tu código del producto o servicio. Opcional; se imprime en el comprobante.

quantitynumberrequerido
unitstring

Unidad SUNAT (catálogo 03). NIU unidad, ZZ servicio, KGM kilogramo, MTR metro, LTR litro.

unit_valuenumberrequerido

Valor unitario **sin IGV**. El IGV lo calcula Krezka según tax_affectation.

tax_affectationenum

Catálogo SUNAT 07. taxed: gravado (10). exempt: exonerado (20). unaffected: inafecto (30). export: exportación (40). free: gratuito (11–16, 21, 31–36 según el caso).

taxedexemptunaffectedexportfree

discountnumber

Descuento por línea, en soles, antes de IGV.

external_idstring
metadataobject

Respuestas

  • 202Nota aceptada y en cola para SUNAT
  • 401API key ausente o inválida
  • 402credit_limit_reached: la cuenta superó su tope de crédito mensual. Regulariza el pago o solicita ampliación.
  • 409Conflicto de estado o de idempotencia: idempotency_key_reused, invoice_not_voidable, cdr_not_available, void_window_expired.
  • 422Parámetros inválidos. code indica el campo o la regla SUNAT incumplida.
POST /credit_notes
curl -X POST https://api.krezka.com/api/v1/invoicing/credit_notes \
  -H "Authorization: Bearer $FALCONEXT_API_KEY" \
  -H "Idempotency-Key: 5f7c1e2a-9b3d-4a6e-8c1f-2d4b6e8a0c12" \
  -H "Content-Type: application/json" \
  -d '{
    "issuer_id": "iss_8Kp2Qm3x",
    "affects_invoice_id": "inv_3xK8p2Qm",
    "reason_code": "01",
    "description": "Devolución de 1 unidad por defecto de fábrica",
    "series": "FC01",
    "items": [
      {
        "description": "Servicio de consultoría — octubre 2026",
        "product_code": "SRV-001",
        "quantity": 2,
        "unit": "ZZ",
        "unit_value": 500,
        "tax_affectation": "taxed",
        "discount": 0
      }
    ],
    "external_id": "string",
    "metadata": {}
  }'
Respuesta · 202
JSON
{
  "id": "cn_7Hd2Lp9q",
  "object": "credit_note",
  "issuer_id": "string",
  "affects_invoice_id": "string",
  "series": "FC01",
  "number": 0,
  "full_number": "FC01-00000018",
  "reason_code": "01",
  "description": "string",
  "status": "pending",
  "status_history": [
    {
      "status": "pending",
      "at": "2025-07-01T14:03:11Z",
      "sunat_code": "0",
      "message": "La Factura numero F001-00001234, ha sido aceptada"
    }
  ],
  "issue_date": "string",
  "currency": "PEN",
  "items": [
    {
      "description": "Servicio de consultoría — octubre 2026",
      "product_code": "SRV-001",
      "quantity": 2,
      "unit": "ZZ",
      "unit_value": 500,
      "tax_affectation": "taxed",
      "discount": 0
    }
  ],
  "totals": {
    "taxable": 0,
    "exempt": 0,
    "unaffected": 0,
    "export": 0,
    "free": 0,
    "discount": 0,
    "tax": 0,
    "total": 1180
  },
  "sunat": {
    "response_code": "0",
    "response_message": "string",
    "hash": "string",
    "accepted_at": "2025-07-01T14:03:11Z",
    "cdr_available": true
  },
  "files": {
    "xml": true,
    "cdr": true,
    "pdf": true
  },
  "external_id": "string",
  "metadata": {},
  "created_at": "2025-07-01T14:03:11Z",
  "updated_at": "2025-07-01T14:03:11Z"
}
Pruébalo
API de Facturación2026-11-01

Se guarda solo en tu navegador (localStorage). Nunca se incluye en el código copiable.

POSThttps://api.krezka.com/api/v1/invoicing/credit_notes
curl -X POST https://api.krezka.com/api/v1/invoicing/credit_notes \
  -H "Authorization: Bearer $FALCONEXT_API_KEY"
Respuesta

Envía una solicitud para ver la respuesta