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
string
required
Tu API Key secreta para autenticar la petición.
string
required
Debe ser
application/json.Body Parameters (Cabecera)
integer
required
Código SIAT de la sucursal.Ejemplo:
0 para Casa Matriz.integer
required
Código SIAT del Punto de Venta.Ejemplo:
0.integer
required
Tipo de documento.Valores:
1= CI2= CEX3= Pasaporte4= Otro5= NIT
string
required
Documento del cliente.El sistema limpiará automáticamente guiones y espacios según el tipo elegido.
string
Complemento del CI.Ejemplo:
"1B".También puede enviarlo junto con el CI dentro de numeroDocumento.Ejemplo: "1234567-1B"string
required
Nombre o Razón Social del cliente.
string
Email del cliente para envío automático de la factura.
integer
required
Método de pago.Ejemplos:
1= Efectivo2= Tarjeta10= Efectivo y Tarjeta
string
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 → 4444000000005555number
required
Monto total de la factura.
Body Parameters (Detalles)
Para uso de API externa, debe enviar obligatoriamente los códigos extraídos de los catálogos del SIAT en cada detalle.string
required
Código o SKU interno de su sistema.
string
required
Nombre del producto o servicio.
number
required
Cantidad vendida.
number
required
Precio por unidad.
number
Descuento por ítem.Si no existe descuento, envíe
0.00.string
required
Código de actividad obtenido del catálogo.Ejemplo:
"6201000"string
required
Código de producto homologado por el SIN.Ejemplo:
"1003914"integer
required
Código de unidad de medida.Ejemplo:
58 = ServiciosEjemplo 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
}