Factura con descuento global
POST /api/documents
Autenticación: Bearer del usuario del tenant (Authorization: Bearer <api_token>).
Cuerpo
Content-Type: application/json
{
"serie_documento": "F001",
"numero_documento": "#",
"fecha_de_emision": "2018-10-09",
"hora_de_emision": "10:11:11",
"codigo_tipo_operacion": "0101",
"codigo_tipo_documento": "01",
"codigo_tipo_moneda": "PEN",
"fecha_de_vencimiento": "2018-10-09",
"numero_orden_de_compra": "0045467898",
"datos_del_cliente_o_receptor": {
"codigo_tipo_documento_identidad": "6",
"numero_documento": "10414711225",
"apellidos_y_nombres_o_razon_social": "EMPRESA XYZ S.A.",
"codigo_pais": "PE",
"ubigeo": "150101",
"direccion": "Av. 2 de Mayo",
"correo_electronico": "demo@gmail.com",
"telefono": "427-1148"
},
"descuentos": [
{
"codigo": "02",
"descripcion": "Descuento Global afecta a la base imponible",
"factor": 0.2,
"monto": 20.0,
"base": 100.0
}
],
"totales": {
"total_descuentos": 20.0,
"total_exportacion": 0.0,
"total_operaciones_gravadas": 100.0,
"total_operaciones_inafectas": 0.0,
"total_operaciones_exoneradas": 0.0,
"total_operaciones_gratuitas": 0.0,
"total_igv": 14.4,
"total_impuestos": 14.4,
"total_valor": 80,
"total_venta": 94.4
},
"items": [
{
"codigo_interno": "P0121",
"descripcion": "Inca Kola 250 ml",
"codigo_producto_sunat": "",
"unidad_de_medida": "NIU",
"cantidad": 2,
"valor_unitario": 50,
"codigo_tipo_precio": "01",
"precio_unitario": 59,
"codigo_tipo_afectacion_igv": "10",
"total_base_igv": 100.0,
"porcentaje_igv": 18,
"total_igv": 18,
"total_impuestos": 18,
"total_valor_item": 100,
"total_item": 118
}
]
}
Respuestas
200 — Comprobante generado
La respuesta típica de POST /api/documents incluye success, data (número, external_id, QR) y links a XML, PDF y CDR.
{
"success": true,
"data": {
"number": "F001-1",
"filename": "20123456789-01-F001-1",
"external_id": "uuid"
},
"links": {
"xml": "https://{subdominio}/downloads/document/xml/{external_id}",
"pdf": "https://{subdominio}/downloads/document/pdf/{external_id}",
"cdr": "https://{subdominio}/downloads/document/cdr/{external_id}"
}
}
Nombre en el SDK
El cuerpo de la consulta es el JSON de la sección Cuerpo. Si instalas el paquete generado en sdks/, esa misma petición es el método emitirComprobanteFacturaBoletaNota.
| Lenguaje | Llamada |
|---|---|
| PHP | TenantDominioDelClienteComprobantesApi::emitirComprobanteFacturaBoletaNota |
| JavaScript | TenantDominioDelClienteComprobantesApi.emitirComprobanteFacturaBoletaNota |
| TypeScript | TenantDominioDelClienteComprobantesApi.emitirComprobanteFacturaBoletaNota |
| Java | TenantDominioDelClienteComprobantesApi.emitirComprobanteFacturaBoletaNota |
| Python | TenantDominioDelClienteComprobantesApi.emitir_comprobante_factura_boleta_nota |
| C# | TenantDominioDelClienteComprobantesApi.EmitirComprobanteFacturaBoletaNotaAsync |
| Go | TenantDominioDelClienteComprobantesAPIService.EmitirComprobanteFacturaBoletaNota |
| Ruby | TenantDominioDelClienteComprobantesApi.emitir_comprobante_factura_boleta_nota |
| Kotlin | TenantDominioDelClienteComprobantesApi.emitirComprobanteFacturaBoletaNota |
| Dart | TenantDominioDelClienteComprobantesApi.emitirComprobanteFacturaBoletaNota |
| Swift | TenantDominioDelClienteComprobantesAPI.emitirComprobanteFacturaBoletaNota |