Para qué sirve
- Anular una factura aceptada por SUNAT que se emitió por error.
- Registrar devoluciones totales o parciales de mercadería.
- Aplicar descuentos o bonificaciones después de emitir la factura.
- Cobrar intereses por mora o penalidades con una nota de débito.
- Automatizar ajustes de precio en ventas recurrentes.
Nota de crédito o nota de débito
Ambas se emiten sobre un comprobante ya existente y se generan con el mismo endpoint, cambiando el tipoDoc:
| Documento | tipoDoc | Para qué sirve |
|---|---|---|
| Nota de crédito | 07 | Disminuye o anula el valor del comprobante: anulación de la operación, devoluciones, descuentos, corrección de errores. |
| Nota de débito | 08 | Aumenta el valor del comprobante: intereses por mora, aumento en el valor, penalidades u otros conceptos. |
El motivo se indica en codmotivo con el código del catálogo de SUNAT que corresponda (hay un catálogo para crédito y otro para débito) y se describe en descripcion. Elige el código que realmente describe la operación; si tienes dudas, confírmalo con tu contador.
Cómo se vincula con el comprobante original
Cada nota debe referenciar al comprobante que modifica con tipoCompRef (01 factura o 03 boleta), serieRef y correlativoRef. Por convención de SUNAT, la serie de la nota empieza con F si modifica una factura (por ejemplo FC01 o FD01) y con B si modifica una boleta.
El cliente de la nota debe ser el mismo del comprobante original, y los montos deben ser coherentes con lo que se corrige: en una anulación total, normalmente coinciden con los del comprobante de referencia.
Una vez generada la nota, envíala a SUNAT con el endpoint de envío descrito en la API de facturación electrónica y guarda la CDR.
Cómo empezar
- Crea tu cuenta gratis en miapi.cloud; el plan gratuito te permite probar sin tarjeta.
- Copia tu token desde el panel admin.miapi.cloud.
- Envíalo en cada petición en la cabecera
Authorization: Bearer TU_TOKEN, siempre por HTTPS.
Prueba primero en beta: emite una factura de ejemplo, envíala y luego genera una nota de crédito que la referencie. Así verificas todo el ciclo antes de pasar a producción.
La cantidad de consultas disponibles depende de tu plan; revisa los planes en miapi.cloud/#planes. Si tienes dudas para integrarla, escríbenos por WhatsApp.
Buenas prácticas
- Comprueba que el comprobante original exista y esté aceptado antes de emitir la nota; puedes hacerlo con la API para validar comprobantes.
- Lleva correlativos propios para cada serie de notas.
- No mezcles motivos: si hay una devolución y un descuento, evalúa si corresponden notas separadas.
- Reintenta solo el envío cuando SUNAT no responda; la nota ya generada conserva su número.
Si prefieres anular un comprobante sin emitir una nota, revisa cuándo procede la comunicación de baja.
Referencia de la API
Todas las peticiones llevan tu token en la cabecera Authorization: Bearer TU_TOKEN.
Lo copias desde tu panel en admin.miapi.cloud después de
crear tu cuenta gratis. Más detalles en la documentación.
Generar XML Nota de Crédito
Genera una nota de crédito para anular o modificar una factura o boleta.
POST https://miapi.cloud/apifact/note/create
curl -X POST "https://miapi.cloud/apifact/note/create" \
-H "Authorization: Bearer TU_TOKEN" \
-H "Content-Type: application/json" \
-d '{"claveSecreta":"TU_CLAVE_SECRETA","comprobante":{"tipoDoc":"07","serie":"FC01","correlativo":"1","codmotivo":"01","descripcion":"ERROR DE EMISION","serieRef":"F001","correlativoRef":"1","tipoCompRef":"01","fechaEmision":"2024-01-01","horaEmision":"12:00:00","tipoMoneda":"PEN","total":118,"mtoIGV":18,"mtoOperGravadas":100,"totalTexto":"SON CIENTO DIECIOCHO CON 00/100 SOLES"},"cliente":{"tipoDoc":"6","numDoc":"20000000002","rznSocial":"EMPRESA DE EJEMPLO S.A.C.","direccion":"AV. DE EJEMPLO 123"},"items":[{"codProducto":"P001","descripcion":"PRODUCTO 1","unidad":"NIU","cantidad":1,"mtoValorUnitario":100,"mtoPrecioUnitario":118,"igv":18}]}'const respuesta = await fetch("https://miapi.cloud/apifact/note/create", {
method: "POST",
headers: {
"Authorization": "Bearer TU_TOKEN",
"Content-Type": "application/json"
},
body: JSON.stringify({
"claveSecreta": "TU_CLAVE_SECRETA",
"comprobante": {
"tipoDoc": "07",
"serie": "FC01",
"correlativo": "1",
"codmotivo": "01",
"descripcion": "ERROR DE EMISION",
"serieRef": "F001",
"correlativoRef": "1",
"tipoCompRef": "01",
"fechaEmision": "2024-01-01",
"horaEmision": "12:00:00",
"tipoMoneda": "PEN",
"total": 118,
"mtoIGV": 18,
"mtoOperGravadas": 100,
"totalTexto": "SON CIENTO DIECIOCHO CON 00/100 SOLES"
},
"cliente": {
"tipoDoc": "6",
"numDoc": "20000000002",
"rznSocial": "EMPRESA DE EJEMPLO S.A.C.",
"direccion": "AV. DE EJEMPLO 123"
},
"items": [
{
"codProducto": "P001",
"descripcion": "PRODUCTO 1",
"unidad": "NIU",
"cantidad": 1,
"mtoValorUnitario": 100,
"mtoPrecioUnitario": 118,
"igv": 18
}
]
}),
});
const datos = await respuesta.json();
console.log(datos);<?php
$ch = curl_init("https://miapi.cloud/apifact/note/create");
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer TU_TOKEN",
"Content-Type: application/json"
],
CURLOPT_POSTFIELDS => json_encode([
"claveSecreta" => "TU_CLAVE_SECRETA",
"comprobante" => [
"tipoDoc" => "07",
"serie" => "FC01",
"correlativo" => "1",
"codmotivo" => "01",
"descripcion" => "ERROR DE EMISION",
"serieRef" => "F001",
"correlativoRef" => "1",
"tipoCompRef" => "01",
"fechaEmision" => "2024-01-01",
"horaEmision" => "12:00:00",
"tipoMoneda" => "PEN",
"total" => 118,
"mtoIGV" => 18,
"mtoOperGravadas" => 100,
"totalTexto" => "SON CIENTO DIECIOCHO CON 00/100 SOLES"
],
"cliente" => [
"tipoDoc" => "6",
"numDoc" => "20000000002",
"rznSocial" => "EMPRESA DE EJEMPLO S.A.C.",
"direccion" => "AV. DE EJEMPLO 123"
],
"items" => [
[
"codProducto" => "P001",
"descripcion" => "PRODUCTO 1",
"unidad" => "NIU",
"cantidad" => 1,
"mtoValorUnitario" => 100,
"mtoPrecioUnitario" => 118,
"igv" => 18
]
]
]),
]);
$datos = json_decode(curl_exec($ch), true);
curl_close($ch);
print_r($datos);import requests
respuesta = requests.post(
"https://miapi.cloud/apifact/note/create",
headers={
"Authorization": "Bearer TU_TOKEN",
"Content-Type": "application/json"
},
json={
"claveSecreta": "TU_CLAVE_SECRETA",
"comprobante": {
"tipoDoc": "07",
"serie": "FC01",
"correlativo": "1",
"codmotivo": "01",
"descripcion": "ERROR DE EMISION",
"serieRef": "F001",
"correlativoRef": "1",
"tipoCompRef": "01",
"fechaEmision": "2024-01-01",
"horaEmision": "12:00:00",
"tipoMoneda": "PEN",
"total": 118,
"mtoIGV": 18,
"mtoOperGravadas": 100,
"totalTexto": "SON CIENTO DIECIOCHO CON 00/100 SOLES"
},
"cliente": {
"tipoDoc": "6",
"numDoc": "20000000002",
"rznSocial": "EMPRESA DE EJEMPLO S.A.C.",
"direccion": "AV. DE EJEMPLO 123"
},
"items": [
{
"codProducto": "P001",
"descripcion": "PRODUCTO 1",
"unidad": "NIU",
"cantidad": 1,
"mtoValorUnitario": 100,
"mtoPrecioUnitario": 118,
"igv": 18
}
]
},
timeout=30,
)
print(respuesta.json()) Generar XML Nota de Débito
Genera una nota de débito para aumentar el valor de una factura o boleta.
POST https://miapi.cloud/apifact/note/create
curl -X POST "https://miapi.cloud/apifact/note/create" \
-H "Authorization: Bearer TU_TOKEN" \
-H "Content-Type: application/json" \
-d '{"claveSecreta":"TU_CLAVE_SECRETA","comprobante":{"tipoDoc":"08","serie":"FD01","correlativo":"1","codmotivo":"01","descripcion":"INTERES POR MORA","serieRef":"F001","correlativoRef":"1","tipoCompRef":"01","fechaEmision":"2024-01-01","horaEmision":"12:00:00","tipoMoneda":"PEN","tipoPago":"Contado","total":118,"mtoIGV":18,"mtoOperGravadas":100,"totalTexto":"SON CIENTO DIECIOCHO CON 00/100 SOLES"},"cliente":{"tipoDoc":"6","numDoc":"20000000002","rznSocial":"EMPRESA DE EJEMPLO S.A.C.","direccion":"AV. DE EJEMPLO 123"},"items":[{"codProducto":"P001","descripcion":"SERVICIO POR INTERES","unidad":"NIU","cantidad":1,"mtoValorUnitario":100,"mtoPrecioUnitario":118,"igv":18}]}'const respuesta = await fetch("https://miapi.cloud/apifact/note/create", {
method: "POST",
headers: {
"Authorization": "Bearer TU_TOKEN",
"Content-Type": "application/json"
},
body: JSON.stringify({
"claveSecreta": "TU_CLAVE_SECRETA",
"comprobante": {
"tipoDoc": "08",
"serie": "FD01",
"correlativo": "1",
"codmotivo": "01",
"descripcion": "INTERES POR MORA",
"serieRef": "F001",
"correlativoRef": "1",
"tipoCompRef": "01",
"fechaEmision": "2024-01-01",
"horaEmision": "12:00:00",
"tipoMoneda": "PEN",
"tipoPago": "Contado",
"total": 118,
"mtoIGV": 18,
"mtoOperGravadas": 100,
"totalTexto": "SON CIENTO DIECIOCHO CON 00/100 SOLES"
},
"cliente": {
"tipoDoc": "6",
"numDoc": "20000000002",
"rznSocial": "EMPRESA DE EJEMPLO S.A.C.",
"direccion": "AV. DE EJEMPLO 123"
},
"items": [
{
"codProducto": "P001",
"descripcion": "SERVICIO POR INTERES",
"unidad": "NIU",
"cantidad": 1,
"mtoValorUnitario": 100,
"mtoPrecioUnitario": 118,
"igv": 18
}
]
}),
});
const datos = await respuesta.json();
console.log(datos);<?php
$ch = curl_init("https://miapi.cloud/apifact/note/create");
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer TU_TOKEN",
"Content-Type: application/json"
],
CURLOPT_POSTFIELDS => json_encode([
"claveSecreta" => "TU_CLAVE_SECRETA",
"comprobante" => [
"tipoDoc" => "08",
"serie" => "FD01",
"correlativo" => "1",
"codmotivo" => "01",
"descripcion" => "INTERES POR MORA",
"serieRef" => "F001",
"correlativoRef" => "1",
"tipoCompRef" => "01",
"fechaEmision" => "2024-01-01",
"horaEmision" => "12:00:00",
"tipoMoneda" => "PEN",
"tipoPago" => "Contado",
"total" => 118,
"mtoIGV" => 18,
"mtoOperGravadas" => 100,
"totalTexto" => "SON CIENTO DIECIOCHO CON 00/100 SOLES"
],
"cliente" => [
"tipoDoc" => "6",
"numDoc" => "20000000002",
"rznSocial" => "EMPRESA DE EJEMPLO S.A.C.",
"direccion" => "AV. DE EJEMPLO 123"
],
"items" => [
[
"codProducto" => "P001",
"descripcion" => "SERVICIO POR INTERES",
"unidad" => "NIU",
"cantidad" => 1,
"mtoValorUnitario" => 100,
"mtoPrecioUnitario" => 118,
"igv" => 18
]
]
]),
]);
$datos = json_decode(curl_exec($ch), true);
curl_close($ch);
print_r($datos);import requests
respuesta = requests.post(
"https://miapi.cloud/apifact/note/create",
headers={
"Authorization": "Bearer TU_TOKEN",
"Content-Type": "application/json"
},
json={
"claveSecreta": "TU_CLAVE_SECRETA",
"comprobante": {
"tipoDoc": "08",
"serie": "FD01",
"correlativo": "1",
"codmotivo": "01",
"descripcion": "INTERES POR MORA",
"serieRef": "F001",
"correlativoRef": "1",
"tipoCompRef": "01",
"fechaEmision": "2024-01-01",
"horaEmision": "12:00:00",
"tipoMoneda": "PEN",
"tipoPago": "Contado",
"total": 118,
"mtoIGV": 18,
"mtoOperGravadas": 100,
"totalTexto": "SON CIENTO DIECIOCHO CON 00/100 SOLES"
},
"cliente": {
"tipoDoc": "6",
"numDoc": "20000000002",
"rznSocial": "EMPRESA DE EJEMPLO S.A.C.",
"direccion": "AV. DE EJEMPLO 123"
},
"items": [
{
"codProducto": "P001",
"descripcion": "SERVICIO POR INTERES",
"unidad": "NIU",
"cantidad": 1,
"mtoValorUnitario": 100,
"mtoPrecioUnitario": 118,
"igv": 18
}
]
},
timeout=30,
)
print(respuesta.json()) Errores frecuentes
| Código | Qué significa |
|---|---|
401 | Token inválido o ausente. Revisa la cabecera Authorization: Bearer TU_TOKEN y tu clave secreta. |
400 / 422 | Datos incompletos o inconsistentes en el cuerpo (montos, series, códigos de catálogo, documento del cliente). Corrige antes de reenviar. |
429 | Alcanzaste el límite de tu plan o enviaste demasiadas peticiones seguidas. |
5xx | El servicio de SUNAT no está disponible o no respondió. Reintenta más tarde sin cambiar serie ni correlativo. |
Preguntas frecuentes
¿Cuándo uso una nota de crédito y cuándo una comunicación de baja?
La comunicación de baja se usa para anular comprobantes en los supuestos y plazos que permite SUNAT. Fuera de ellos, o cuando hay que corregir o devolver, se usa una nota de crédito. Confirma el caso con tu contador.
¿Qué serie debe tener la nota?
Empieza con F si modifica una factura y con B si modifica una boleta, por ejemplo FC01 o BC01. El correlativo lo controla tu sistema.
¿Dónde indico el motivo?
En el campo codmotivo, con el código del catálogo de SUNAT para notas de crédito o de débito, y una descripción en el campo descripcion.
¿La nota se envía sola a SUNAT?
No. Primero la generas y luego la envías con el endpoint de envío a SUNAT, igual que una factura, y guardas la CDR que devuelve.
¿Puedo probar sin emitir notas reales?
Sí, en el entorno beta de SUNAT. Regístrate gratis en miapi.cloud para empezar.
APIs relacionadas
-
API Facturación Electrónica
Emite facturas y boletas electrónicas desde tu propio software: envías los datos en JSON, generamos y firmamos el XML y lo enviamos a SUNAT.
-
API Comunicación de Baja
Anula comprobantes electrónicos e informa tus boletas a SUNAT con la comunicación de baja y el resumen diario, y consulta su resultado con el ticket.
-
API Validar Comprobante
Comprueba ante SUNAT si una factura, boleta o nota que recibiste está aceptada, y consulta los comprobantes emitidos y recibidos de tu RUC desde tu sistema.
Empieza gratis hoy
Crea tu cuenta gratis, copia tu token y haz tu primera consulta en minutos. Sin tarjeta de crédito.