Version: 1.0.11

Nota de Crédito Electrónica

Descripción General

La API de Notas de Crédito Electrónicas permite la emisión de documentos para anular o modificar facturas y boletas previamente emitidas. Cada nota de crédito debe hacer referencia a un comprobante existente y especificar el motivo de la modificación, cumpliendo con las especificaciones técnicas de SUNAT.

Tipos de Notas de Crédito Disponibles

Esta sección incluye endpoints para los siguientes tipos de notas de crédito:

• Nota de Crédito para Factura - Para anular o modificar facturas
• Nota de Crédito para Boleta - Para anular o modificar boletas
• Nota de Crédito con ID Externo - Referenciando documentos por ID externo

Motivos de Emisión (Códigos SUNAT)

• 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

Estructura de Petición

{
  "serie_documento": "FC01",
  "numero_documento": "#",
  "fecha_de_emision": "2024-11-05",
  "hora_de_emision": "10:11:11",
  "codigo_tipo_documento": "07",
  "codigo_tipo_nota": "01",
  "motivo_o_sustento_de_nota": "Error al emitir comprobante",
  "codigo_tipo_moneda": "PEN",
  "numero_orden_de_compra": "0045467898",
  "documento_afectado": {
    "external_id": "a7d75ecc-061d-46f6-8ee4-2521a5bbec1d"
  },
  "datos_del_cliente_o_receptor": {
    "codigo_tipo_documento_identidad": "6",
    "numero_documento": "10414711225",
    "apellidos_y_nombres_o_razon_social": "EMPRESA XYZ S.A.",
    "codigo_pais": "PE",
    "ubigeo": "150101",
    "direccion": "Av. 2 de Mayo",
    "correo_electronico": "demo@gmail.com",
    "telefono": "427-1148"
  },
  "totales": {
    "total_exportacion": 0,
    "total_operaciones_gravadas": 100,
    "total_operaciones_inafectas": 0,
    "total_operaciones_exoneradas": 0,
    "total_operaciones_gratuitas": 0,
    "total_igv": 18,
    "total_impuestos": 18,
    "total_valor": 100,
    "total_venta": 118
  },
  "items": [
    {
      "codigo_interno": "P0121",
      "descripcion": "Inca Kola 250 ml",
      "codigo_producto_sunat": "",
      "unidad_de_medida": "NIU",
      "cantidad": 2,
      "valor_unitario": 50,
      "codigo_tipo_precio": "01",
      "precio_unitario": 59,
      "codigo_tipo_afectacion_igv": "10",
      "total_base_igv": 100,
      "porcentaje_igv": 18,
      "total_igv": 18,
      "total_impuestos": 18,
      "total_valor_item": 100,
      "total_item": 118
    }
  ]
}

Consideraciones Importantes

• Las notas de crédito siempre deben referenciar a un documento válido previamente emitido
• El tipo de documento debe ser "07" para notas de crédito
• Es necesario especificar el código y motivo de la nota
• Los datos del cliente deben coincidir con el documento original
• La serie de la nota de crédito debe seguir el formato:
  • "FC" para facturas (ejemplo: FC01)
  • "BC" para boletas (ejemplo: BC01)

Implementación

Para implementar la emisión de notas de crédito en su sistema:

1. Identifique el documento a modificar (factura o boleta)
2. Obtenga el external_id del documento afectado
3. Prepare el payload con los datos requeridos y el motivo de la nota
4. Envíe la solicitud al endpoint /api/documents
5. Procese la respuesta y almacene los documentos generados

Authentication

OAuth 2.0: fastura_auth

Security Scheme Type:	oauth2
OAuth Flow (implicit):	Authorization URL: https://empresa1.demo3pro6.ibu.pe Scopes: write: Modificar... read: Leer..

API Key: api_key

Security Scheme Type:	apiKey
Header parameter name:	api_key