Fixed - API de Integración

POST /ventaCrear

Ventas

Emite un Comprobante Fiscal Electrónico (CFE). En Swagger: Try it out → elegí un ejemplo del dropdown → editá los campos → Execute.

La respuesta incluye tres opciones para imprimir o mostrar el comprobante:

• urlA4: comprobante A4 en PDF.
• urlTicket: ticket térmico en PDF (formato estrecho).
• htmlTicket: ticket en HTML (útil para preview o impresión web).

Identificación del cliente

Cómo identifica Fixed a un cliente ya existente (para actualizarlo) en vez de crear uno nuevo, dentro de la misma empresa y mismo tipoDocumento:

1. Si documento no viene vacío: busca por documento. Si encuentra, actualiza ese cliente. Si no encuentra ningún cliente con ese documento, busca por mailEnvioFactura (ver punto 2); si tampoco encuentra por mail, crea un cliente nuevo con ese documento.
2. Si documento viene vacío pero mailEnvioFactura no: busca por mailEnvioFactura (sin distinguir mayúsculas/minúsculas ni espacios). Si encuentra, actualiza ese cliente. Si no encuentra, crea uno nuevo.
3. Si tanto documento como mailEnvioFactura vienen vacíos: siempre crea un cliente nuevo.

Esto permite, por ejemplo, facturar a nombre de clientes de e-commerce que en un primer pedido no informan documento (solo mail), y que si en un pedido posterior sí lo informan, Fixed complete el documento en la misma ficha de cliente en vez de duplicarla.

Límites de caracteres

Estos campos tienen un largo máximo; si se supera, la request se rechaza con un error (no se trunca en silencio):

• cliente.razonSocial: 150 caracteres (E18).
• cliente.nombreComercial: 150 caracteres (E18).
• lineasVenta[].descripcion: 80 caracteres (E24).
• lineasVenta[].descripcionLarga: 500 caracteres (E24).

Reintentos seguros (idempotencia)

Si no recibiste la respuesta de un llamado anterior (por ejemplo por un corte de red) y no sabés si la venta se llegó a emitir, no reintentes a ciegas: mandá el campo idempotencyKey la primera vez que intentás emitir esa venta, y reusá exactamente el mismo valor, con exactamente los mismos datos, para reintentar esa misma venta. Fixed te devuelve la misma respuesta de la primera vez (sea éxito o error) en vez de reprocesar.

Una idempotencyKey queda asociada para siempre a los datos de esa venta puntual: no se puede reusar para una venta distinta, ni para reintentar la misma venta con datos corregidos. Si mandás la misma idempotencyKey con datos diferentes a los originales, Fixed devuelve el error E23. Para emitir una venta distinta, o la misma venta con datos corregidos, generá una idempotencyKey nueva.

Cómo generar la idempotencyKey: tiene que identificar el intento de emisión en sí, nunca derivarse del contenido de la venta. Si la generás a partir de los datos de la venta (por ejemplo un hash de sus campos), dos ventas distintas que coincidan en todos sus datos (mismo cliente, mismo importe, etc.) van a chocar contra la misma key, y la segunda no se va a emitir: va a recibir de vuelta el resultado de la primera.

• Recomendado: un UUID v4 generado justo antes de intentar emitir esa venta puntual.
• También válido: tu propio ID de pedido/orden interno, si ya tenés uno único por venta.

idempotencyKey es opcional: si no lo mandás, el comportamiento es el de siempre, sin protección contra reintentos duplicados.

Body

IAPIFixedVentaCrearEntrada

No se aceptan campos adicionales.

IAPIFixedCliente

No se aceptan campos adicionales.

IAPIFixedVentaLineaCrearEntrada

No se aceptan campos adicionales.

CfeDgiTasaIva

Valor del campo cfeDgi de la tasa de IVA configurada en Fixed. Debe coincidir exactamente con uno de estos valores (sensible a mayúsculas): - Basic: Tasa básica (22%) - Min: Tasa mínima (10%) - Exe: Exento de IVA - Exp: Exportación - Otro: Otras tasas - NoFac: No facturable - Suspenso: Suspenso - Percibido: Percibido - literalE: Literal E

Valores: "Basic", "Exp", "Min", "Exe", "Otro", "NoFac", "Suspenso", "Percibido", "literalE", ""

Ejemplos

Venta a consumidor final

Sin cliente identificado. Una línea en UYU con IVA incluido en precio.

{
  "cliente": null,
  "fecha": "23/06/2026",
  "moneda": "UYU",
  "montoBruto": 1,
  "lineasVenta": [
    {
      "cantidad": 1,
      "descripcion": "Pan francés",
      "descripcionLarga": "Pan francés artesanal",
      "rubro": "Panadería",
      "tasaIva": "Basic",
      "descuentoMonto": 0,
      "precioUnitario": 120
    }
  ],
  "observaciones": "",
  "totalAPagar": 120,
  "redondear": false
}

Venta con múltiples líneas

Caso típico en POS/e-commerce: varias líneas con distintos rubros y tasas de IVA. Ajustá tasaIva según lo configurado en Fixed (Basic=22%, Min=10%, Exe=0%).

{
  "cliente": null,
  "fecha": "23/06/2026",
  "moneda": "UYU",
  "montoBruto": 1,
  "lineasVenta": [
    {
      "cantidad": 2,
      "descripcion": "Pan francés",
      "descripcionLarga": "Pan francés artesanal",
      "rubro": "Panadería",
      "tasaIva": "Basic",
      "descuentoMonto": 0,
      "precioUnitario": 120
    },
    {
      "cantidad": 1,
      "descripcion": "Leche entera",
      "descripcionLarga": "Leche entera 1 litro",
      "rubro": "Lácteos",
      "tasaIva": "Min",
      "descuentoMonto": 0,
      "precioUnitario": 55
    },
    {
      "cantidad": 3,
      "descripcion": "Bolsa reciclable",
      "descripcionLarga": "Bolsa biodegradable",
      "rubro": "Accesorios",
      "tasaIva": "Exe",
      "descuentoMonto": 0,
      "precioUnitario": 10
    }
  ],
  "observaciones": "",
  "totalAPagar": 325,
  "redondear": false
}

Venta con cliente identificado

Cliente con RUT. Si ya existe, se actualizan sus datos.

{
  "cliente": {
    "tipoDocumento": 2,
    "documento": "219314970014",
    "razonSocial": "Panadería El Buen Pan S.A.",
    "nombreComercial": "El Buen Pan",
    "domicilio": "Av. Italia 1234",
    "localidad": "Montevideo",
    "departamento": "Montevideo",
    "domicilioEntrega": "Av. Italia 1234",
    "mailEnvioFactura": "facturacion@ejemplo.com",
    "telefono": "099123456",
    "observaciones": ""
  },
  "fecha": "23/06/2026",
  "moneda": "UYU",
  "montoBruto": 1,
  "lineasVenta": [
    {
      "cantidad": 2,
      "descripcion": "Docena de medialunas",
      "descripcionLarga": "Medialunas de manteca",
      "rubro": "Panadería",
      "tasaIva": "Basic",
      "descuentoMonto": 0,
      "precioUnitario": 450
    }
  ],
  "observaciones": "Pedido mostrador",
  "totalAPagar": 900,
  "redondear": false,
  "local": ""
}

Venta en dólares

Comprobante en USD. Verificar cotización vigente de la empresa.

{
  "cliente": null,
  "fecha": "23/06/2026",
  "moneda": "USD",
  "montoBruto": 1,
  "lineasVenta": [
    {
      "cantidad": 1,
      "descripcion": "Servicio exportación",
      "descripcionLarga": "",
      "rubro": "Servicios",
      "tasaIva": "Exp",
      "descuentoMonto": 0,
      "precioUnitario": 50
    }
  ],
  "observaciones": "",
  "totalAPagar": 50,
  "redondear": false
}

Venta a crédito

Igual a una venta simple, pero con formaDePago: "credito" en vez del default "contado".

{
  "cliente": null,
  "fecha": "23/06/2026",
  "moneda": "UYU",
  "montoBruto": 1,
  "lineasVenta": [
    {
      "cantidad": 1,
      "descripcion": "Pan francés",
      "descripcionLarga": "Pan francés artesanal",
      "rubro": "Panadería",
      "tasaIva": "Basic",
      "descuentoMonto": 0,
      "precioUnitario": 120
    }
  ],
  "observaciones": "",
  "totalAPagar": 120,
  "redondear": false,
  "formaDePago": "credito"
}

Venta con descuento en una línea

descuentoMonto es un importe (no un porcentaje): se resta del precioUnitario x cantidad de esa línea antes de calcular el IVA.

{
  "cliente": null,
  "fecha": "23/06/2026",
  "moneda": "UYU",
  "montoBruto": 1,
  "lineasVenta": [
    {
      "cantidad": 2,
      "descripcion": "Docena de medialunas",
      "descripcionLarga": "Medialunas de manteca",
      "rubro": "Panadería",
      "tasaIva": "Basic",
      "descuentoMonto": 100,
      "precioUnitario": 450
    }
  ],
  "observaciones": "Descuento por pronto pago",
  "totalAPagar": 800,
  "redondear": false
}

Respuestas

HTTP 200

CFE emitido. Respuesta incluye urlA4, urlTicket y htmlTicket

IAPIFixedVentaCrearSalida

No se aceptan campos adicionales.

HTTP 500

Error de validación o negocio (ver codigoError)

Example 1

{
  "descripcion": "Moneda incorrecta",
  "codigoError": "E02",
  "idCFE": "",
  "numero": 0,
  "serie": "",
  "tipoCFE": "",
  "comprobante": "",
  "urlA4": "",
  "urlVerificarCFE": ""
}

POST /ventaDevolucionTotalCrear

Ventas

Emite una nota de crédito por devolución total de un CFE existente.

Solo se admiten devoluciones totales: no es posible devolver un importe parcial. totalADevolver debe coincidir exactamente con el total de la factura original.

Admite idempotencyKey para reintentos seguros, con el mismo comportamiento que en POST /ventaCrear (ver esa sección para el detalle, incluyendo cómo generar la key correctamente): mismos datos + misma key devuelve el resultado cacheado; datos distintos con la misma key devuelve E23.

Body

IAPIFixedVentaDevolucionTotalEntrada

No se aceptan campos adicionales.

Ejemplos

Devolución total de un CFE

Reemplazá idCFE y totalADevolver con los de la venta original.

{
  "idCFE": "REEMPLAZAR_CON_ID_CFE",
  "fecha": "23/06/2026",
  "cotizacion": 1,
  "ordenCompra": "",
  "local": "",
  "adenda": "",
  "totalADevolver": 120
}

Devolución de una venta en USD

cotizacion: 1 usa la cotización original de la venta (recomendado). Solo poné otro valor si necesitás forzar una cotización distinta.

{
  "idCFE": "REEMPLAZAR_CON_ID_CFE",
  "fecha": "23/06/2026",
  "cotizacion": 1,
  "ordenCompra": "",
  "local": "",
  "adenda": "",
  "totalADevolver": 50
}

Respuestas

HTTP 200

Nota de crédito emitida correctamente

IAPIFixedVentaDevolucionTotalCrearSalida

No se aceptan campos adicionales.

HTTP 500

Error de validación o negocio

Example 1

{
  "descripcion": "Moneda incorrecta",
  "codigoError": "E02",
  "idCFE": "",
  "numero": 0,
  "serie": "",
  "tipoCFE": "",
  "comprobante": "",
  "urlA4": "",
  "urlVerificarCFE": ""
}

POST /ventaConsulta

Ventas

Consulta el estado y datos de un CFE emitido previamente.

Body

IAPIFixedVentaConsultaEntrada

No se aceptan campos adicionales.

Ejemplos

Consultar estado de un CFE

{
  "idCFE": "REEMPLAZAR_CON_ID_CFE"
}

Respuestas

HTTP 200

Datos del CFE

IAPIFixedVentaConsultaSalida

No se aceptan campos adicionales.

HTTP 500

CFE no encontrado u otro error

Example 1

{
  "descripcion": "El idCFE no existe para la empresa",
  "codigoError": "C08",
  "idCFE": "",
  "estadoDGI": "",
  "motivoRechazoDGI": "",
  "numero": 0,
  "serie": "",
  "tipoCFE": "",
  "comprobante": "",
  "urlA4": "",
  "urlVerificarCFE": ""
}

POST /consultaFacturacionDia

Ventas

Lista los comprobantes emitidos en una fecha.

Body

IAPIFixedConsultaFacturacionDiaEntrada

No se aceptan campos adicionales.

Ejemplos

Comprobantes de un día

{
  "fecha": "23/06/2026"
}

Respuestas

HTTP 200

Listado de comprobantes del día

IAPIFixedConsultaFacturacionDiaSalida

No se aceptan campos adicionales.

ConsultaFacturacion

No se aceptan campos adicionales.

HTTP 500

Error de validación

Example 1

{
  "descripcion": "Formato fecha inválida",
  "codigoError": "E08",
  "comprobantes": []
}

POST /imprimirCFE

Ventas

Genera o regenera las URLs e HTML de impresión de un CFE emitido. Útil si el CFE ya existe pero se necesita volver a obtener sus URLs de impresión.

La respuesta incluye:

• urlA4: comprobante A4 en PDF.
• urlTicket: ticket térmico en PDF (formato estrecho).
• htmlTicket: ticket en HTML (útil para preview o impresión web).

Body

Ejemplos

Obtener ticket y PDF de un CFE

Devuelve urlA4, urlTicket (ticket térmico) y htmlTicket para imprimir o mostrar el comprobante.

{
  "idCFE": "REEMPLAZAR_CON_ID_CFE"
}

Respuestas

HTTP 200

CFE encontrado. Respuesta incluye urlA4, urlTicket y htmlTicket

IAPIFixedImprimirCFESalida

No se aceptan campos adicionales.

HTTP 500

CFE no encontrado u otro error

Example 1

{
  "descripcion": "El idCFE no existe para la empresa",
  "codigoError": "C08",
  "idCFE": "",
  "estadoDGI": "",
  "motivoRechazoDGI": "",
  "numero": 0,
  "serie": "",
  "tipoCFE": "",
  "comprobante": "",
  "urlA4": "",
  "urlVerificarCFE": ""
}

POST /obtenerProximoNumero

Ventas

Consulta la serie y el próximo número que se usaría al emitir, sin emitir nada. El tipo de comprobante se deriva de tipoDocumento y tipo (venta/devolución): RUT es e-Factura / e-Factura Nota de Crédito, el resto es e-Ticket / e-Ticket Nota de Crédito. No contempla comprobantes de exportación.

Es solo informativo: el número puede cambiar si otro comprobante se emite entre esta consulta y el llamado real a ventaCrear (no reserva el número).

Body

IAPIFixedObtenerProximoNumeroEntrada

No se aceptan campos adicionales.

Respuestas

HTTP 200

Serie y próximo número a usar

IAPIFixedObtenerProximoNumeroSalida

No se aceptan campos adicionales.

HTTP 500

Error de validación o negocio (ver codigoError)

Example 1

{
  "descripcion": "No existe un CAE disponible para el tipo de comprobante 111.",
  "codigoError": "E02",
  "serie": "",
  "numero": 0,
  "tcfe": 111
}

GET /keepAlive

General

Verifica que la API esté activa. No requiere autenticación ni body.

Respuestas

HTTP 200

API activa

POST /validarCredenciales

General

Verifica que el par x-api-key / x-api-secret sea válido y devuelve los datos no sensibles de la empresa asociada. Recomendado como primer paso al integrar.

Respuestas

HTTP 200

Credenciales válidas

IAPIFixedValidarCredencialesSalida

No se aceptan campos adicionales.

HTTP 401

Credenciales inválidas

Example 1

{
  "descripcion": "API key inválida o inactiva",
  "codigoError": "A02",
  "rut": "",
  "nombreEmpresa": ""
}

POST /consultarCFERecibidos

Compras

Consulta los CFEs recibidos (comprobantes de compra) emitidos por otras empresas hacia la empresa, dentro de un rango de fechas, opcionalmente filtrados por el RUT del emisor/proveedor.

fechaDesde y fechaHasta son formato dd/mm/aaaa, inclusive. El rango entre ambos no puede superar los 31 días.

Por default, solo consulta lo que Fixed ya tiene guardado. Con consultarNuevos: true se fuerza además una consulta en vivo a DGI por CFEs nuevos en ese rango (igual que el botón "Consultar en DGI nuevos CFEs recibidos" de la web) — puede demorar bastante más, y depende de que el mail con el comprobante ya le haya llegado a Fixed para poder guardarlo (DGI solo informa metadatos, no el XML). Si esa consulta falla por cualquier motivo, la respuesta igual incluye los datos ya guardados, con una advertencia en descripcion.

Body

IAPIFixedConsultarCFERecibidosEntrada

No se aceptan campos adicionales.

Respuestas

HTTP 200

Listado de CFEs recibidos en el rango de fechas

IAPIFixedConsultarCFERecibidosSalida

No se aceptan campos adicionales.

IAPIFixedCFERecibido

No se aceptan campos adicionales.

HTTP 500

Error de validación (ver codigoError)

Example 1

{
  "descripcion": "El rango entre fechaDesde y fechaHasta no puede superar los 31 días.",
  "codigoError": "E02",
  "cfesRecibidos": []
}

POST /clienteMostrar

Clientes

Busca un cliente activo por tipo y número de documento.

Body

IAPIFixedClienteMostrarEntrada

No se aceptan campos adicionales.

Ejemplos

Buscar cliente por RUT

{
  "tipoDocumento": 2,
  "documento": "219314970014"
}

Buscar cliente por cédula

{
  "tipoDocumento": 3,
  "documento": "12345678"
}

Respuestas

HTTP 200

Cliente encontrado o null si no existe

IAPIFixedClienteMostrarSalida

No se aceptan campos adicionales.

Cliente

No se aceptan campos adicionales.

HTTP 500

Error al buscar cliente

Example 1

{
  "descripcion": "No existe cliente con documento y/o tipo documento indicado",
  "codigoError": "0",
  "cliente": null
}

POST /consultarRUTDGI

Clientes

Consulta los datos de un RUT en DGI (razón social, domicilio fiscal y tipo de contribuyente), útil para prellenar los datos de un cliente antes de emitir un comprobante. Requiere que la empresa cuente con firma electrónica vigente en Fixed.

Límite: 20 consultas por minuto por empresa. Si se supera, responde 429.

Body

IAPIFixedConsultarRUTDGIEntrada

No se aceptan campos adicionales.

Respuestas

HTTP 200

Datos del RUT encontrados en DGI

IAPIFixedConsultarRUTDGISalida

No se aceptan campos adicionales.

HTTP 500

Error al consultar el RUT (ver codigoError)

Example 1

{
  "descripcion": "El RUT '219314970014' no fue encontrado en DGI.",
  "codigoError": "E03",
  "razonSocial": "",
  "domicilioFiscal": "",
  "tipoContribuyente": ""
}

POST /localesListado

Catálogos

Listado de locales de la empresa. No requiere body.

Respuestas

HTTP 200

Listado de locales de la empresa

IAPIFixedLocalesListadoSalida

No se aceptan campos adicionales.

IAPIFixedLocal

No se aceptan campos adicionales.

HTTP 500

Error al obtener catálogo

Example 1

{
  "descripcion": "Empresa no encontrada",
  "codigoError": "E02"
}

POST /serviciosRubrosListado

Catálogos

Listado de rubros de servicios. No requiere body.

Respuestas

HTTP 200

Listado de rubros de servicios

IAPIFixedServiciosRubrosListadoSalida

No se aceptan campos adicionales.

ServiciosRubro

No se aceptan campos adicionales.

HTTP 500

Error al obtener catálogo

Example 1

{
  "descripcion": "Empresa no encontrada",
  "codigoError": "E02"
}

POST /consultaCAE

Catálogos

Consulta los CAE (autorizaciones de numeración) de la empresa, con su información completa.

Con soloDisponibles: true devuelve solo los vigentes (disponible == true y no vencidos). Sin ese campo, o en false, devuelve todos los CAE cargados, vencidos o agotados incluidos.

Body

IAPIFixedConsultaCAEEntrada

No se aceptan campos adicionales.

Respuestas

HTTP 200

Listado de CAE

IAPIFixedConsultaCAESalida

No se aceptan campos adicionales.

IAPIFixedCAE

No se aceptan campos adicionales.

HTTP 500

Error de validación

Example 1

{
  "descripcion": "Empresa no encontrada",
  "codigoError": "E01",
  "caes": []
}

POST /serviciosRubrosAgregarEditar

Catálogos

Crea o edita un rubro de servicios.

Body

IAPIFixedServiciosRubrosAgregarEditarEntrada

No se aceptan campos adicionales.

Ejemplos

Agregar rubro de servicios

{
  "accion": "agregar",
  "rubro": {
    "version": 1,
    "id": "",
    "codigo": "PAN",
    "nombre": "Panadería",
    "padreId": null,
    "nombreCompleto": "Panadería",
    "activo": true,
    "esHoja": true,
    "ultimaEdicion": 0
  }
}

Editar rubro existente

Usá el id del rubro obtenido desde /serviciosRubrosListado.

{
  "accion": "editar",
  "rubro": {
    "version": 1,
    "id": "REEMPLAZAR_CON_ID_RUBRO",
    "codigo": "PAN",
    "nombre": "Panadería y confitería",
    "padreId": null,
    "nombreCompleto": "Panadería y confitería",
    "activo": true,
    "esHoja": true,
    "ultimaEdicion": 0
  }
}

Respuestas

HTTP 200

Rubro creado o editado correctamente

IAPIFixedServiciosRubrosAgregarEditarSalida

No se aceptan campos adicionales.

HTTP 500

Error de validación

Example 1

{
  "descripcion": "Acción no es correcta, debe ser agregar o editar",
  "codigoError": "E01",
  "rubro": null
}