Estructura para generar nota de crédito

POSThttps://api.factpro.la/api/v3/documentos

Headers

Name	Value
Content-Type	application/json
Authorization	Bearer <token>

Body

ATRIBUTO	VALOR	REQUISITO	LONGUITUD
serie	Debe ingresar "F" para FACTURAS y con "B" para BOLETAS DE VENTA. Para su generación debe tener en cuenta que el comprobante debe estar aceptado.	Obligatorio	4 exacto
numero	Número correlativo del documento	Obligatorio	1 hasta 8
tipo_operacion	En todos los casos se utiliza por defecto: 1 1= Venta interna 2= Exportación 3= Operación Sujeta a Detracción 4= Operación Sujeta a Detracción- Servicios de Transporte Carga 5= Ventas no domiciliados que no califican como exportación	Obligatorio	4 exacto
tipo_nota	1 = Anulación de la operación 2=Anulación por error en el RUC 3=Corrección por error en la descripción 4=Descuento global 5=Descuento por ítem 6=Devolución total 7=Devolución por ítem 8=Bonificación 9=Disminución en el valor 10=Otros Conceptos 11=Ajustes de operaciones de exportación 12=Ajustes afectos al IVAP 13=Ajustes – montos y/o fechas de pago	Obligatorio
motivo_nota	Añadir una descripción por el cual se realiza la nota	Obligatorio
enviar_automaticamente_al_cliente	Dirección de email false = No se enviara true = Se enviará automáticamente	Opcional
DATOS DEL CLIENTE
cliente_tipo_documento	1=Otros 2=DNI 3=CE 4=RUC 5=Pasaporte	Obligatorio	1 exacto
cliente_numero_documento	Ejemplo: RUC del CLIENTE, número de DNI, Etc.	Obligatorio	1 hasta 15
cliente_denomiacion	Razón o nombre completo del CLIENTE.	Obligatorio	1 hasta 100
codigo_pais	Colocar el país del CLIENTE, por ejemplo Perú = PE	Opcional	2 exacto
ubigeo	Debe ingresar número por código de Ubigeo , por ejemplo 150101	Opcional	2 exacto
cliente_direccion	Dirección completa (OPCIONAL en caso de ser una BOLETA DE VENTA o NOTA ASOCIADA).	Condicional	1 hasta 100
cliente_email	Correo referencial	Opcional
cliente_telefono	Teléfono referencial	Opcional
ITEMS
unidad	Enviar las unidades de medida, por ejemplo para Unidad es = NIU NIU = PRODUCTO ZZ = SERVICIO	Obligatorio	2 hasta 5
codigo	Opcional, código interno del producto por ejemplo P0121	Opcional	1 hasta 250
descripcion	Nombre del producto	Obligatorio	1 hasta 250
cantidad	Ejemplo: 10.00	Obligatorio	1 hasta 12 enteros, hasta con 10 decimales
precio_unitario	Con IGV. Ejemplo: 59	Obligatorio	1 hasta 12 enteros, hasta con 10 decimales
tipo_tax	1=Gravado - Operación Onerosa 2=Exonerado - Operación Onerosa 3=Exonerado – Transferencia Gratuita 4=Inafecto - Operación Onerosa 5=Exportación de bienes o servicios	Obligatorio	2 exacto
CONDICIÓN DE PAGO	Solo aplica si es tipo de nota (13=Ajustes – montos y/o fechas de pago)
tipo_de_condicion	1 = Crédito	Condicional	1 exacto
fecha_de_pago	Solo aplica si es a crédito tendrán un formato: 01-12-2025	Condicional	10 exacto
monto	Solo aplica si es a crédito debe ir el monto de la cuota, ejemplo 50.00	Condicional	1 hasta 12 enteros con 2 decimales
OTROS CAMPOS
formato_pdf	Puedes elegir entre a4 o ticket para mostrar automáticamente el formato del PDF	Obligatorio
numero_orden	Texto de 0 hasta 1000 caracteres.	Opcional
codigo	Texto de 0 hasta 1000 caracteres.	Opcional
observaciones	Texto de 0 hasta 1000 caracteres.	Opcional

Body

{
  "serie": "FC01",
  "tipo_operacion":"1",
  "numero": "#",
  "tipo_nota": "1",// catálogo: https://docs.factpro.la/catalogos-sunat/catalogo-10-codigos-de-tipo-de-nota-de-debito
  "motivo_nota": "Error al emitir comprobante",
  "documento_afectado": {
    "tipo_documento": "7", //catálogo: https://docs.factpro.la/catalogos-sunat/catalogo-08-tipos-de-documentos
    "serie": "F100",
    "numero": "10"
  },
  "cliente": {
    "cliente_tipo_documento": "1", //catálogo: https://docs.factpro.la/catalogos-sunat/catalogo-06-tipo-de-documento-de-identidad
    "cliente_numero_documento": "20605577246",
    "cliente_denominacion": "CORPORACION VEL PERU S.A.C.",
    "codigo_pais": "",
    "cliente_direccion": "Av.",
    "cliente_email": "",
    "cliente_telefono": ""
  },
  "items": [
    {
      "unidad": "NIU", //catálogo: https://docs.factpro.la/unidades-de-medida-universal
      "codigo": "",
      "descripcion": "test note credit",
      "cantidad": 1,
      "precio": 100,
      "tipo_tax": "1" //catálogo: https://docs.factpro.la/catalogos-sunat/catalogo-07-impuestos
    }
  ],
  "observaciones": "",
  "formato_pdf": "a4"
}

Response

200

{
    "success": true,
    "data": {
        "number": "F001-5",
        "filename": "20415963255-01-F001-5",
        "external_id": "103c8710-6c6e-4b7b-8d7b-c59f642c7a71",
        "number_to_letter": "Ciento dieciocho  con 00/100 ",
        "hash": "gLOlpznxBvvhT/BUUugMYDhQo84=",
        "qr": "iVBORw0KGgoAAAANSUhEUgAAAJYAAACWCAIAAACzY+a1AAAACXBIWXMAAA7EAAAOxAGVKw4bAAAEgklEQVR4nO2d3XYbMQgG4568/yund45bqwQBWneOZy7t1U/yHZAWIXz7+vr6EDK/Xj0B6aKEeJQQjxLiUUI8SohHCfEoIR4lxKOEeJQQjxLi+Uw+d7vd+oM9htTvHd4/fBzi+="
    },
    "links": {
        "xml": "https://factpro.pe/downloads/document/xml/103c8710-6c6e-4b7b-8d7b-c59f642c7a71",
        "pdf": "https://factpro.pe/downloads/document/pdf/103c8710-6c6e-4b7b-8d7b-c59f642c7a71",
        "cdr": "https://factpro.pe/downloads/document/cdr/103c8710-6c6e-4b7b-8d7b-c59f642c7a71"
    },
    "response": {
        "code": "0",
        "description": "La Factura numero F001-5, ha sido aceptada",
        "notes": []
    }
}