Emitir Tasas (sector 41)

POST/api/v1/facturas

puntoVentaId es el UUID obligatorio de un punto activo de la empresa; determina internamente el punto y la sucursal SIAT. cliente.codigoCliente es obligatorio y lo asigna tu sistema al cliente. El backend asigna siempre usuario=FALMUS. montoTasa es obligatorio, no negativo y se excluye del monto sujeto al IVA. Los campos desconocidos se rechazan. Responde 201, 400, 401, 403, 404, 422 o 503. No envíes secretos SIAT.

Header requerido X-API-KeyVer operaciones de Facturas

Contrato de la operación

Emitir Compra Venta con Tasas

Prueba rápida del sector 41 mediante POST /api/v1/facturas. Requiere X-API-Key, facturas.crear y factura_compra_venta_tasas habilitada para empresa y clave.

puntoVentaId es el UUID obligatorio de un punto activo de la empresa; determina internamente el punto y la sucursal SIAT. cliente.codigoCliente es obligatorio y lo asigna tu sistema al cliente. El backend asigna siempre usuario=FALMUS. montoTasa es obligatorio, no negativo y se excluye del monto sujeto al IVA. Los campos desconocidos se rechazan. Responde 201, 400, 401, 403, 404, 422 o 503. No envíes secretos SIAT.

Ejemplo

Solicitud de ejemplo

Clave ficticia; no se ejecuta desde esta página

cURL · POST

export FALMUS_API_URL='https://staging-api.falmus.com/api/v1'
export FALMUS_API_KEY='flm_test_REEMPLAZA_CON_TU_CLAVE'

curl --request POST \
  --url "$FALMUS_API_URL/facturas" \
  --header "X-API-Key: $FALMUS_API_KEY" \
  --header "Content-Type: application/json" \
  --data-raw '{
  "codigoDocumentoSector": 41,
  "puntoVentaId": "{{puntoVentaId}}",
  "cliente": {
    "codigoTipoDocumento": 5,
    "numeroDocumento": "99001",
    "razonSocial": "CLIENTE DEMO",
    "codigoCliente": "CLIENTE99001"
  },
  "pago": { "codigoMetodoPago": 1 },
  "datosSector": {
    "codigoMoneda": 1,
    "tipoCambio": 1,
    "montoTasa": 20
  },
  "detalles": [
    {
      "actividadEconomica": "{{actividadEconomica}}",
      "codigoProductoSin": {{codigoProductoSin}},
      "descripcion": "Servicio sujeto a tasa",
      "cantidad": 1,
      "codigoUnidadMedida": 58,
      "precioUnitario": 500,
      "datosSector": {}
    }
  ]
}'

Respuesta

Ejemplo de respuesta

201 Createdapplication/json

JSON

{
  "message": "factura emitida correctamente",
  "data": {
    "id": "00000000-0000-4000-8000-000000000001",
    "numeroFactura": 42,
    "cuf": "A1B2C3D4E5F60718293A4B5C6D7E8F90123456789ABCDEF0123456789ABCDEF0",
    "codigoRecepcion": "00000000-0000-4000-8000-000000000042",
    "codigoEstado": 908,
    "estado": "aceptado",
    "ambiente": "pruebas",
    "fechaEmision": "2026-08-30T16:10:00-04:00",
    "montoTotal": 500,
    "codigoPuntoVenta": 0,
    "codigoDocumentoSector": 41,
    "urlQr": "https://pilotosiat.impuestos.gob.bo/consulta/QR?nit=123456789&cuf=A1B2C3D4E5F60718293A4B5C6D7E8F90123456789ABCDEF0123456789ABCDEF0&numero=42&t=2",
    "urlXml": "https://api.example.test/api/v1/public/facturas/A1B2C3D4E5F60718293A4B5C6D7E8F90123456789ABCDEF0123456789ABCDEF0/xml",
    "urlPdf": "https://api.example.test/api/v1/public/facturas/A1B2C3D4E5F60718293A4B5C6D7E8F90123456789ABCDEF0123456789ABCDEF0/pdf"
  }
}

Datos ficticios; los identificadores y valores cambian en cada respuesta.

Volver a Facturas