Estructura para generar nota de crédito
POSThttps://api.factpro.la/api/v3/documentos
Headers
Content-Type
application/json
Authorization
Bearer <token>
Body
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 6=Registro civil 7=Cédula de ciudadanía
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": "F100",
"numero": "#",
"tipo_operacion": "1",
"cliente": {
"cliente_tipo_documento": "4",
"cliente_numero_documento": "20605577241",
"cliente_denominacion": "CORPORACION VEL PERU S.A.C.",
"cliente_direccion": "Av.",
"cliente_email": "[email protected]",
"cliente_telefono": ""
},
"items": [
{
"unidad": "NIU",
"codigo": "",
"descripcion": "PC 3434",
"cantidad": 1,
"precio": 100,
"tipo_tax": "1",
"descuento": 0.00
}
],
"condicion_de_pago": [
{
"tipo_de_condicion": "0",
"forma_de_pago":"0",
"monto": 0
}
],
"observaciones": "",
"formato_pdf": "a4"
}
Response
{
"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": []
}
}
Última actualización