Nubo Factura electrónica
Emite una factura usando codigo_tipo_documento = 01.
Authorizations
Enviar como Bearer API_TOKEN. El token se configura por usuario en Integracion API > Configuracion o en la ventana de Usuarios.
Alternativa para emision externa: puedes enviar el mismo token en este header si no deseas usar Bearer.
Si se envia, debe coincidir con un dominio permitido. Si no se envia, la validacion usa la IP publica del cliente.
Usar application/json.
Usar application/json para las APIs con body.
Body application/json
Serie habilitada para el establecimiento del usuario emisor. Ejemplos: F001, B001, FC01, FD01.
Puede omitirse para factura y boleta. El backend asigna el correlativo automatico de la serie cuando llega vacio o como #.
Fecha del comprobante en formato YYYY-MM-DD.
Hora del comprobante en formato HH:mm:ss.
Fecha de vencimiento. Aplica sobre todo en credito; si no aplica puede igualarse a la fecha de emision.
01 factura, 03 boleta, 07 nota de credito, 08 nota de debito.
Tipo de operacion SUNAT. Para venta interna gravada normalmente se usa 0101.
Moneda ISO del comprobante. Ejemplos: PEN, USD.
Tipo de cambio cuando la moneda no es soles. Para PEN puede enviarse 1.
Orden de compra o referencia comercial del cliente.
Objeto con los datos tributarios y de contacto del cliente receptor.
6 RUC, 1 DNI, 0 sin documento u otros codigos SUNAT validos.
Numero del documento de identidad. Para factura debe ser RUC valido.
Nombre completo o razon social del receptor.
Codigo pais ISO. Para Peru usar PE.
Ubigeo del domicilio fiscal o comercial.
Direccion del cliente.
Correo para envio del comprobante si la accion de email esta activa.
Telefono de contacto del receptor.
Arreglo con una o mas lineas del comprobante. Cada objeto representa un producto o servicio.
Codigo interno del producto o servicio en el sistema externo.
Codigo de producto SUNAT cuando aplique.
Descripcion que se imprimira en el comprobante.
Unidad SUNAT. Para servicios o unidades comunes suele ser NIU.
Cantidad vendida.
Valor unitario sin IGV.
Codigo de tipo de precio. Normalmente 01 para precio unitario con IGV.
Precio unitario con impuestos incluidos.
Afectacion IGV. Ejemplo 10 para gravado operacion onerosa.
Base imponible del IGV de la linea.
Porcentaje IGV aplicado. Normalmente 18.
Monto de IGV de la linea.
Suma de impuestos de la linea.
Valor total de la linea sin impuestos.
Importe total de la linea con impuestos.
Modelo comercial del producto si se desea imprimir en el PDF.
Lote del producto cuando aplique.
Series individuales del producto cuando aplique.
Objeto con los importes globales del comprobante.
Suma de operaciones gravadas sin IGV.
Suma de operaciones exoneradas.
Suma de operaciones inafectas.
IGV total del comprobante.
Suma de impuestos globales.
Valor de venta sin impuestos.
Subtotal con impuestos antes de redondeos o descuentos globales.
Total final a pagar.
Pagos aplicados al momento de emitir.
Metodo de pago configurado. Ejemplo: 01 efectivo.
Destino del pago configurado cuando el metodo lo requiera.
Monto pagado.
Objeto para controlar salidas posteriores a la emision.
Genera y firma XML cuando llega en true.
Envia email al cliente si existe correo disponible.
Formato del PDF. Ejemplo: a4, ticket.
curl --request POST \
--url https://tu-empresa.nubo.devex.pe/api/integration/documents \
--header 'Accept: application/json' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer API_TOKEN' \
--data '{
"serie_documento": "F001",
"fecha_de_emision": "2026-06-03",
"hora_de_emision": "10:30:00",
"codigo_tipo_documento": "01",
"codigo_tipo_operacion": "0101",
"codigo_tipo_moneda": "PEN",
"datos_del_cliente_o_receptor": {
"codigo_tipo_documento_identidad": "6",
"numero_documento": "20123456789",
"apellidos_y_nombres_o_razon_social": "CLIENTE DEMO S.A.C.",
"direccion": "Av. Demo 123"
},
"items": [{
"descripcion": "Servicio de integracion",
"unidad_de_medida": "NIU",
"cantidad": 1,
"valor_unitario": 100,
"codigo_tipo_precio": "01",
"precio_unitario": 118,
"codigo_tipo_afectacion_igv": "10",
"total_base_igv": 100,
"porcentaje_igv": 18,
"total_igv": 18,
"total_impuestos": 18,
"total_valor_item": 100,
"total_item": 118
}],
"totales": {
"total_operaciones_gravadas": 100,
"total_igv": 18,
"total_impuestos": 18,
"total_valor": 100,
"subtotal_venta": 118,
"total_venta": 118
}
}'{
"success": true,
"data": {
"number": "F001-8",
"external_id": "uuid",
"state_type_description": "Aceptado",
"id": 123
},
"links": {
"xml": "https://tu-empresa.nubo.devex.pe/downloads/document/xml/uuid",
"pdf": "https://tu-empresa.nubo.devex.pe/downloads/document/pdf/uuid",
"cdr": "https://tu-empresa.nubo.devex.pe/downloads/document/cdr/uuid"
}
}