Ejemplos de Notas de Crédito - Tipo `04`
Este documento proporciona ejemplos completos de solicitudes de notas de crédito para diferentes escenarios y tipos de clientes.
Tabla de Contenidos
- Tipos de Notas de Crédito
- Ejemplo 1: Nota de Crédito por Devolución
- Ejemplo 2: Nota de Crédito por Descuento
- Ejemplo 3: Nota de Crédito por Anulación Total
- Ejemplo 4: Nota de Crédito por Ajuste de Precio
- Ejemplo 5: Nota de Crédito Múltiple
- Ejemplo 6: Nota de Crédito con detallesAdicionales por Ítem
- Referencia del Documento Modificado
- Errores Comunes y Soluciones
- "DEVOLUCION": Devolución de producto
- "DESCUENTO": Ajuste de precio/descuento
- "ANULACION": Anulación completa
- "AJUSTE": Ajuste general
- "ERROR_EN_FACTURACION": Corrección de error de facturación
Tipos de Notas de Crédito
Motivo de Nota de Crédito (`motivo`)
Tipos de Documento Modificado (`docModificado.tipo`)
| Código | Descripción |
| ------ | ------------- |
01 | Factura |
03 | Liquidación |
05 | Nota de débito |
18 | Orden de compra |
Ejemplo 1: Nota de Crédito por Devolución
Escenario: Cliente devuelve producto defectuoso
{
"ruc": "0707012605001",
"tipo": "04",
"id_externo": "NC-2025-001",
"nota": {
"fecha": "07/12/2025",
"establecimiento": "001",
"puntoEmision": "001",
"secuencial": "000001234",
"motivo": "DEVOLUCION - Producto defectuoso recibido por cliente",
"cliente": {
"nombre": "DIEGO JIMENEZ",
"tipoIdentificacion": "05",
"documento": "0912345678",
"correo": "[email protected]",
"direccion": "Av. Principal #123"
},
"docModificado": {
"tipo": "01",
"numero": "001-001-000012343",
"fechaEmision": "01/12/2025"
},
"total": 115.00
},
"detalles": [
{
"codigoPrincipal": "P-001",
"descripcion": "Producto A devuelto - falla en fabricación",
"cantidad": -2,
"precioUnitario": 50.00,
"descuento": 0,
"precioTotalSinImpuesto": -100.00,
"impuestos": [
{
"codigo": "2",
"codigoPorcentaje": "4",
"tarifa": 15,
"baseImponible": -100.00,
"valor": -15.00
}
]
}
],
"notificaciones": {
"email": "[email protected]",
"webhook_url": "https://miapp.com/webhooks/credit-notes"
}
}
Respuesta Esperada
{
"status": "ok",
"code": 200,
"message": "Document created successfully",
"data": {
"id": 2,
"company_id": 1,
"external_id": "NC-2025-001",
"document_type": "04",
"access_key": "0712202501070701260050010010000012341234567890",
"series": "001001",
"sequential": "000001234",
"status": "AUTHORIZED",
"authorization_number": "0712202501070701260050010010000012341234567890",
"authorization_date": "07/12/2025 11:00:00",
"issue_date": "2025-12-07",
"created_at": "2025-12-07T10:30:00.000000Z",
"updated_at": "2025-12-07T11:00:00.000000Z"
}
}
Ejemplo 2: Nota de Crédito por Descuento
Escenario: Descuento comercial por volumen o promoción
{
"ruc": "0707012605001",
"tipo": "04",
"id_externo": "NC-2025-002",
"nota": {
"fecha": "07/12/2025",
"establecimiento": "001",
"puntoEmision": "001",
"secuencial": "000001235",
"motivo": "DESCUENTO - Descuento por volumen de compra",
"cliente": {
"nombre": "CORPORACIÓN EJEMPLO S.A.",
"tipoIdentificacion": "04",
"documento": "1712345678001",
"correo": "[email protected]"
},
"docModificado": {
"tipo": "01",
"numero": "001-001-000012344",
"fechaEmision": "05/12/2025"
},
"total": 46.80
},
"detalles": [
{
"codigoPrincipal": "DESC-001",
"descripcion": "Descuento comercial por volumen - 20%",
"cantidad": -1,
"precioUnitario": 40.00,
"descuento": 0,
"precioTotalSinImpuesto": -40.00,
"impuestos": [
{
"codigo": "2",
"codigoPorcentaje": "2",
"tarifa": 12,
"baseImponible": -40.00,
"valor": -4.80
}
]
},
{
"codigoPrincipal": "DESC-002",
"descripcion": "Descuento promocional",
"cantidad": -1,
"precioUnitario": 2.00,
"descuento": 0,
"precioTotalSinImpuesto": -2.00,
"impuestos": [
{
"codigo": "2",
"codigoPorcentaje": "2",
"tarifa": 12,
"baseImponible": -2.00,
"valor": -0.24
}
]
}
],
"notificaciones": {
"email": "[email protected]"
}
}
Ejemplo 3: Nota de Crédito por Anulación Total
Escenario: Anulación completa de factura por error
{
"ruc": "0707012605001",
"tipo": "04",
"id_externo": "NC-2025-003",
"nota": {
"fecha": "07/12/2025",
"establecimiento": "001",
"puntoEmision": "001",
"secuencial": "000001236",
"motivo": "ANULACION - Factura emitida con datos incorrectos",
"cliente": {
"nombre": "JUAN PEREZ",
"tipoIdentificacion": "05",
"documento": "0923456789",
"correo": "[email protected]"
},
"docModificado": {
"tipo": "01",
"numero": "001-001-000012345",
"fechaEmision": "06/12/2025"
},
"total": 230.00
},
"detalles": [
{
"codigoPrincipal": "ANUL-001",
"descripcion": "Anulación total de factura",
"cantidad": -1,
"precioUnitario": 200.00,
"descuento": 0,
"precioTotalSinImpuesto": -200.00,
"impuestos": [
{
"codigo": "2",
"codigoPorcentaje": "4",
"tarifa": 15,
"baseImponible": -200.00,
"valor": -30.00
}
]
}
],
"notificaciones": {
"email": "[email protected]"
}
}
Ejemplo 4: Nota de Crédito por Ajuste de Precio
Escenario: Ajuste de precio después de la facturación
{
"ruc": "0707012605001",
"tipo": "04",
"id_externo": "NC-2025-004",
"nota": {
"fecha": "07/12/2025",
"establecimiento": "001",
"puntoEmision": "001",
"secuencial": "000001237",
"motivo": "AJUSTE - Ajuste de precio acordado",
"cliente": {
"nombre": "EMPRESA MODERNA S.A.",
"tipoIdentificacion": "04",
"documento": "1791234567001",
"correo": "[email protected]"
},
"docModificado": {
"tipo": "01",
"numero": "001-001-000012340",
"fechaEmision": "04/12/2025"
},
"total": -34.50
},
"detalles": [
{
"codigoPrincipal": "AJUSTE-001",
"descripcion": "Ajuste de precio - negociación",
"cantidad": -1,
"precioUnitario": 30.00,
"descuento": 0,
"precioTotalSinImpuesto": -30.00,
"impuestos": [
{
"codigo": "2",
"codigoPorcentaje": "2",
"tarifa": 12,
"baseImponible": -30.00,
"valor": -3.60
}
]
},
{
"codigoPrincipal": "AJUSTE-002",
"descripcion": "Ajuste adicional",
"cantidad": -1,
"precioUnitario": 0.90,
"descuento": 0,
"precioTotalSinImpuesto": -0.90,
"impuestos": [
{
"codigo": "2",
"codigoPorcentaje": "4",
"tarifa": 15,
"baseImponible": -0.90,
"valor": -0.135
}
]
}
],
"notificaciones": {
"email": "[email protected]"
}
}
Ejemplo 5: Nota de Crédito Múltiple
Escenario: Múltiplesitems de diferentes facturas
{
"ruc": "0707012605001",
"tipo": "04",
"id_externo": "NC-2025-005",
"nota": {
"fecha": "07/12/2025",
"establecimiento": "001",
"puntoEmision": "001",
"secuencial": "000001238",
"motivo": "AJUSTE - Ajuste final de mes",
"cliente": {
"nombre": "DISTRIBUIDORA XYZ CÍA. LTDA.",
"tipoIdentificacion": "04",
"documento": "1702345678001",
"correo": "[email protected]"
},
"docModificado": {
"tipo": "01",
"numero": "001-001-000012350",
"fechaEmision": "01/12/2025"
},
"total": 575.00
},
"detalles": [
{
"codigoPrincipal": "PROD-001",
"descripcion": "Devolución de mercancía",
"cantidad": -10,
"precioUnitario": 25.00,
"descuento": 0,
"precioTotalSinImpuesto": -250.00,
"impuestos": [
{
"codigo": "2",
"codigoPorcentaje": "4",
"tarifa": 15,
"baseImponible": -250.00,
"valor": -37.50
}
]
},
{
"codigoPrincipal": "PROD-002",
"descripcion": "Producto dañado - crédito",
"cantidad": -5,
"precioUnitario": 50.00,
"descuento": 0,
"precioTotalSinImpuesto": -250.00,
"impuestos": [
{
"codigo": "2",
"codigoPorcentaje": "4",
"tarifa": 15,
"baseImponible": -250.00,
"valor": -37.50
}
]
},
{
"codigoPrincipal": "DESC-001",
"descuento": -50.00,
"precioTotalSinImpuesto": -50.00,
"impuestos": []
}
],
"notificaciones": {
"email": "[email protected]"
}
}
Ejemplo 6: Nota de Crédito con detallesAdicionales por Ítem
Escenario: Ajuste con información adicional trazable por detalle (lote, serie, observación técnica).
{
"ruc": "0707012605001",
"tipo": "04",
"id_externo": "NC-2025-006",
"nota": {
"fecha": "07/12/2025",
"establecimiento": "001",
"puntoEmision": "001",
"secuencial": "000001239",
"motivo": "AJUSTE - Correccion por diferencias en lote entregado",
"cliente": {
"nombre": "HOSPITAL CENTRAL S.A.",
"tipoIdentificacion": "04",
"documento": "1798888888001",
"correo": "[email protected]",
"direccion": "Av. Salud Norte 456"
},
"docModificado": {
"tipo": "01",
"numero": "001-001-000012349",
"fechaEmision": "05/12/2025"
},
"total": 56.00
},
"detalles": [
{
"codigoPrincipal": "MED-001",
"descripcion": "Ajuste por devolucion parcial de kit",
"cantidad": -1,
"precioUnitario": 50.00,
"descuento": 0,
"precioTotalSinImpuesto": -50.00,
"impuestos": [
{
"codigo": "2",
"codigoPorcentaje": "2",
"tarifa": 12,
"baseImponible": -50.00,
"valor": -6.00
}
],
"detallesAdicionales": [
{
"nombre": "Lote",
"valor": "L-2025-001"
},
{
"nombre": "Serie",
"valor": "SN-5489-AB"
},
{
"nombre": "ObservacionTecnica",
"valor": "Empaque deteriorado en recepcion"
}
]
}
],
"notificaciones": {
"email": "[email protected]"
}
}
Notas de validación para detallesAdicionales:
- Disponible por cada item de
detallesen notas de crédito (04). - Máximo 10 elementos por detalle.
- Cada elemento debe incluir
nombreyvalor(máximo 300 caracteres).
Referencia del Documento Modificado
Para notas de crédito, debes hacer referencia al documento que modificas:
"docModificado": {
"tipo": "01", // Tipo de documento: 01=Factura, 03=Liquidación
"numero": "001-001-000012343", // Número completo del documento
"fechaEmision": "01/12/2025" // Fecha de emisión del documento original
}
Importantee:
- La fecha del documento modificado debe ser anterior a la nota de crédito
- El número de autorización del documento modificado debe ser válido
Errores Comunes y Soluciones
Error 1: "El documento modificado no existe"
Causa: El número de documento referenciado no está en el sistema.
Solución: Verifica que el número de documento sea correcto y que pertenezca a la empresa.
Error 2: "La fecha de emisión del documento modificado es mayor a la nota de crédito"
Causa: La nota de crédito no puede ser anterior al documento que modifica.
Solución: Asegúrate de que la fecha de la nota de crédito sea posterior a la del documento modificado.
Error 3: "El total de la nota de crédito no puede ser mayor al documento modificado"
Causa: Estás intentando creer más que el documento original.
Solución: El total de la nota de crédito debe ser menor o igual al total del documento modificado.
Error 4: "Las cantidades en detalles deben ser negativas"
Causa: Estás usando cantidades positivas para снижение.
Solución: Usa cantidades negativas en los detalles de la nota de crédito (ej: cantidad: -2).