curl -X POST "https://www.sharkfac.com/api/v1/facturas/emitir" \
-H "Content-Type: application/json" \
-H "x-sharkfac-key: TU_API_KEY_AQUI" \
-d '{
"codigoSucursal": 0,
"codigoPuntoVenta": 0,
"codigoDocumentoIdentidad": 5,
"numeroDocumento": "99002",
"nombreRazonSocial": "CLIENTE NUEVO",
"codigoCliente": "99002",
"codigoMetodoPago": 2,
"numeroTarjeta": "44445555",
"montoTotal": 350.00,
"email": "cliente@example.com",
"gestionarInventario": false,
"detalles": [
{
"codigoProductoPropio": "PROD-001",
"descripcion": "Suscripción Anual",
"cantidad": 1,
"precioUnitario": 350.00,
"montoDescuento": 0.00,
"codigoActividad": "6201000",
"codigoProductoSin": "1003914",
"unidadMedida": 58
}
]
}'
const payload = {
codigoSucursal: 0,
codigoPuntoVenta: 0,
codigoDocumentoIdentidad: 5,
numeroDocumento: "99002",
nombreRazonSocial: "CLIENTE NUEVO",
codigoCliente: "99002",
codigoMetodoPago: 2,
numeroTarjeta: "44445555",
montoTotal: 350.00,
email: "cliente@example.com",
gestionarInventario: false,
detalles: [
{
codigoProductoPropio: "PROD-001",
descripcion: "Suscripción Anual",
cantidad: 1,
precioUnitario: 350.00,
montoDescuento: 0.00,
codigoActividad: "6201000",
codigoProductoSin: "1003914",
unidadMedida: 58
}
]
};
fetch("https://www.sharkfac.com/api/v1/facturas/emitir", {
method: "POST",
headers: {
"Content-Type": "application/json",
"x-sharkfac-key": "TU_API_KEY_AQUI"
},
body: JSON.stringify(payload)
})
.then(res => res.json())
.then(console.log);
Facturación
Emitir Factura
Crea y emite una factura electrónica validada por el SIAT.
POST
/
api
/
v1
/
facturas
/
emitir
curl -X POST "https://www.sharkfac.com/api/v1/facturas/emitir" \
-H "Content-Type: application/json" \
-H "x-sharkfac-key: TU_API_KEY_AQUI" \
-d '{
"codigoSucursal": 0,
"codigoPuntoVenta": 0,
"codigoDocumentoIdentidad": 5,
"numeroDocumento": "99002",
"nombreRazonSocial": "CLIENTE NUEVO",
"codigoCliente": "99002",
"codigoMetodoPago": 2,
"numeroTarjeta": "44445555",
"montoTotal": 350.00,
"email": "cliente@example.com",
"gestionarInventario": false,
"detalles": [
{
"codigoProductoPropio": "PROD-001",
"descripcion": "Suscripción Anual",
"cantidad": 1,
"precioUnitario": 350.00,
"montoDescuento": 0.00,
"codigoActividad": "6201000",
"codigoProductoSin": "1003914",
"unidadMedida": 58
}
]
}'
const payload = {
codigoSucursal: 0,
codigoPuntoVenta: 0,
codigoDocumentoIdentidad: 5,
numeroDocumento: "99002",
nombreRazonSocial: "CLIENTE NUEVO",
codigoCliente: "99002",
codigoMetodoPago: 2,
numeroTarjeta: "44445555",
montoTotal: 350.00,
email: "cliente@example.com",
gestionarInventario: false,
detalles: [
{
codigoProductoPropio: "PROD-001",
descripcion: "Suscripción Anual",
cantidad: 1,
precioUnitario: 350.00,
montoDescuento: 0.00,
codigoActividad: "6201000",
codigoProductoSin: "1003914",
unidadMedida: 58
}
]
};
fetch("https://www.sharkfac.com/api/v1/facturas/emitir", {
method: "POST",
headers: {
"Content-Type": "application/json",
"x-sharkfac-key": "TU_API_KEY_AQUI"
},
body: JSON.stringify(payload)
})
.then(res => res.json())
.then(console.log);
Crea una nueva factura electrónica, la firma digitalmente, la envía al SIAT para validación, genera el PDF/XML y opcionalmente la envía por correo al cliente.
Headers
Body Parameters (Cabecera)
Documento del cliente.El sistema limpiará automáticamente guiones y espacios según el tipo elegido.
Complemento del CI.Ejemplo:
"1B".También puede enviarlo junto con el CI dentro de numeroDocumento.Ejemplo: "1234567-1B"Requerido si el método de pago incluye tarjeta (
2, 10, etc).Debe enviar al menos 8 dígitos (4 primeros y 4 últimos).El sistema enmascarará automáticamente el centro del número.Ejemplo:44445555 → 4444000000005555Body Parameters (Detalles)
Para uso de API externa, debe enviar obligatoriamente los códigos extraídos de los catálogos del SIAT en cada detalle.Ejemplo de petición
curl -X POST "https://www.sharkfac.com/api/v1/facturas/emitir" \
-H "Content-Type: application/json" \
-H "x-sharkfac-key: TU_API_KEY_AQUI" \
-d '{
"codigoSucursal": 0,
"codigoPuntoVenta": 0,
"codigoDocumentoIdentidad": 5,
"numeroDocumento": "99002",
"nombreRazonSocial": "CLIENTE NUEVO",
"codigoCliente": "99002",
"codigoMetodoPago": 2,
"numeroTarjeta": "44445555",
"montoTotal": 350.00,
"email": "cliente@example.com",
"gestionarInventario": false,
"detalles": [
{
"codigoProductoPropio": "PROD-001",
"descripcion": "Suscripción Anual",
"cantidad": 1,
"precioUnitario": 350.00,
"montoDescuento": 0.00,
"codigoActividad": "6201000",
"codigoProductoSin": "1003914",
"unidadMedida": 58
}
]
}'
const payload = {
codigoSucursal: 0,
codigoPuntoVenta: 0,
codigoDocumentoIdentidad: 5,
numeroDocumento: "99002",
nombreRazonSocial: "CLIENTE NUEVO",
codigoCliente: "99002",
codigoMetodoPago: 2,
numeroTarjeta: "44445555",
montoTotal: 350.00,
email: "cliente@example.com",
gestionarInventario: false,
detalles: [
{
codigoProductoPropio: "PROD-001",
descripcion: "Suscripción Anual",
cantidad: 1,
precioUnitario: 350.00,
montoDescuento: 0.00,
codigoActividad: "6201000",
codigoProductoSin: "1003914",
unidadMedida: 58
}
]
};
fetch("https://www.sharkfac.com/api/v1/facturas/emitir", {
method: "POST",
headers: {
"Content-Type": "application/json",
"x-sharkfac-key": "TU_API_KEY_AQUI"
},
body: JSON.stringify(payload)
})
.then(res => res.json())
.then(console.log);
Respuesta
{
"id": 112,
"numeroFactura": 29,
"cuf": "1E46BB9FA459FFDDCBDB68D8844FB8.......",
"cufd": "FBQXxCU8OJSEhBFFQTgyMjdGRkY3QzluelpWWEZhVUMjI...........",
"fechaEmision": "2026-05-23T04:21:59.7494526",
"estadoSiat": "VALIDADA",
"nombreRazonSocial": "CLIENTE NUEVO",
"numeroDocumento": "99002",
"complemento": null,
"codigoCliente": "99002",
"montoTotal": 350.00,
"montoTotalSujetoIva": 350.00,
"leyenda": "Ley N° 453: Puedes acceder a la reclamación cuando tus derechos han sido vulnerados.",
"usuario": "Admin",
"detalles": [
{
"codigoProducto": "PROD-001",
"descripcion": "Suscripción Anual",
"cantidad": 1,
"precioUnitario": 350.00,
"subTotal": 350.00,
"numeroSerie": null,
"numeroImei": null
}
],
"cafc": null
}

