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 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