Estructura para generar facturas

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
fecha_de_emision	Opcional Debe ser la fecha actual. Ejemplo: 2024-05-14	Opcional	10 exacto
moneda	Opcional , por defecto siempre sera en MONEDA "PEN" PEN = SOLES USD= DÓLARES	Opcional	3 exacto
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
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	Ejemplo: 100	Obligatorio	1 hasta 12 enteros, hasta con 10 decimales
incluye_tax	Si el precio que utilizas en tu app no incluye impuesto debes de colocar: false Si el precio que envias ya incluye el impuesto, puedes enviarnos como : true o no es necesario enviar esta variable	Opcional	4 hasta 5
tipo_tax	1=Gravado - Operación Onerosa 20=Exonerado - Operación Onerosa 21=Exonerado – Transferencia Gratuita 30=Inafecto - Operación Onerosa 40=Exportación de bienes o servicios	Obligatorio	2 exacto
descuento	Ejemplo: 5	Opcional	1 hasta 12 enteros, hasta con 10 decimales
CONDICIÓN DE PAGO
tipo_de_condicion	0= Contado y 1 = Crédito	Condicional	1 exacto
fecha_de_pago	Solo aplica si es a crédito tendrán un formato: 2024-01-03	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

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": []
    }
}