Skip to main content
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
      }
    ]
  }'

Documentation Index

Fetch the complete documentation index at: https://sharkfac.mintlify.app/llms.txt

Use this file to discover all available pages before exploring further.

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

​
x-sharkfac-key
string
required
Tu API Key secreta para autenticar la petición.
​
Content-Type
string
required
Debe ser application/json.

​
Body Parameters (Cabecera)

​
codigoSucursal
integer
required
Código SIAT de la sucursal.Ejemplo: 0 para Casa Matriz.
​
codigoPuntoVenta
integer
required
Código SIAT del Punto de Venta.Ejemplo: 0.
​
codigoDocumentoIdentidad
integer
required
Tipo de documento.Valores:
  • 1 = CI
  • 2 = CEX
  • 3 = Pasaporte
  • 4 = Otro
  • 5 = NIT
​
numeroDocumento
string
required
Documento del cliente.El sistema limpiará automáticamente guiones y espacios según el tipo elegido.
​
complemento
string
Complemento del CI.Ejemplo: "1B".También puede enviarlo junto con el CI dentro de numeroDocumento.Ejemplo: "1234567-1B"
​
nombreRazonSocial
string
required
Nombre o Razón Social del cliente.
​
email
string
Email del cliente para envío automático de la factura.
​
codigoMetodoPago
integer
required
Método de pago.Ejemplos:
  • 1 = Efectivo
  • 2 = Tarjeta
  • 10 = Efectivo y Tarjeta
​
numeroTarjeta
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 → 4444000000005555
​
montoTotal
number
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.
​
detalles[].codigoProductoPropio
string
required
Código o SKU interno de su sistema.
​
detalles[].descripcion
string
required
Nombre del producto o servicio.
​
detalles[].cantidad
number
required
Cantidad vendida.
​
detalles[].precioUnitario
number
required
Precio por unidad.
​
detalles[].montoDescuento
number
Descuento por ítem.Si no existe descuento, envíe 0.00.
​
detalles[].codigoActividad
string
required
Código de actividad obtenido del catálogo.Ejemplo: "6201000"
​
detalles[].codigoProductoSin
string
required
Código de producto homologado por el SIN.Ejemplo: "1003914"
​
detalles[].unidadMedida
integer
required
Código de unidad de medida.Ejemplo: 58 = Servicios

​
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
      }
    ]
  }'

​
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
}