La API REST de Facturando permite que cualquier software, ERP, app o e-commerce cree ventas con emisión de comprobante electrónico automática ante ARCA, y administre productos, categorías, clientes y proveedores de tu cuenta.
Todas las solicitudes van sobre HTTPS, se autentican con un token Bearer y responden JSON. La regla más importante:
Un solo POST /sales hace todo. Valida cliente, emisor y sucursal, calcula impuestos y descuentos, registra el pago, emite el comprobante ante ARCA y devuelve CAE, punto de venta, número y las URLs públicas del PDF. La venta solo se confirma si ARCA la autoriza; si no, no queda nada creado.
Consultá GET /billers, GET /warehouses y GET /tax-rates para obtener los IDs de emisor, sucursal e impuestos.
Creá o buscá el cliente en /customers (con el CUIT alcanza: se completa desde ARCA).
Enviá el POST /sales con los ítems. Listo: el comprobante está emitido.
Para probar con tu cuenta, ingresá tu API key y se habilita la Consola: venta rápida, consultas de cualquier recurso y notas de crédito, con la respuesta real de la API.
URL base y ambientes
Base URL
https://x.facturando.com/x/api/rest-api
Todos los endpoints de esta documentación son relativos a esa URL. Por ejemplo, GET /products es https://x.facturando.com/x/api/rest-api/products.
Los comprobantes que se emiten desde la API son reales y quedan registrados ante ARCA. Para probar tu integración usá un emisor de pruebas de tu cuenta o coordiná con soporte antes de emitir. No emitas "para ver qué pasa".
Autenticación
Incluí el token en el header Authorization de cada solicitud:
Header
Authorization: Bearer fct_tu_token
Los tokens se crean y revocan desde x.facturando.com → Configuración → API. El valor completo se muestra una sola vez al crearlo: guardalo en un lugar seguro.
Podés asignarles un nombre (por integración) y una fecha de expiración. Un token expirado o desactivado responde 401.
Cada solicitud queda registrada (endpoint, código de respuesta, duración) y podés verla en la pestaña de uso.
El token identifica a tu cuenta: todos los recursos que consultes o crees pertenecen a ella.
Al obtener, crear o actualizar un registro, la respuesta es el objeto en sí. Los errores devuelven un objeto con la clave error y el código HTTP correspondiente:
Error (400)
{"error":"biller_id es requerido"}
Ante un error interno, la respuesta trae un request_id. Citalo al escribir a soporte: con él ubicamos el detalle completo en nuestros registros.
Error (500)
{"error":"Error interno del servidor","request_id":"6f1c2a9e-3b0d-4c58-9a1e-2d7f0c3b8e41"}
Evaluá siempre el código HTTP. Un 2xx significa que la operación se completó; en el caso de POST /sales, que el comprobante fue aceptado por ARCA.
Paginación, orden y búsqueda
Los endpoints de listado (GET /recurso) aceptan estos parámetros de consulta:
Parámetro
Tipo
Descripción
page
integer
Número de página (default: 1)
per_page
integer
Resultados por página, máximo 100 (default: 50)
sort_by
string
Campo para ordenar (default: created_at)
sort_dir
string
Dirección del orden: asc o desc (default: desc)
search
string
Búsqueda por nombre en products, customers y suppliers
Para crear una venta y emitir su comprobante se realiza un solo POST /sales, que ejecuta todo el proceso automáticamente:
Valida que el cliente, el emisor y la sucursal existan en tu cuenta.
Calcula impuestos por cada ítem según su tax_rate_id y tax_method.
Aplica descuentos por ítem (valor fijo o porcentaje con %).
Crea la venta con todos los totales calculados y sus ítems.
Registra el pago si el monto pagado es mayor a 0.
Emite el comprobante electrónico ante ARCA a través del emisor indicado.
Devuelve la venta con la respuesta de facturación y las URLs del PDF.
Ejemplos cURL
# Crear venta con facturacion electronica automaticacurl -XPOST"https://x.facturando.com/x/api/rest-api/sales"\ -H"Authorization: Bearer fct_a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6"\ -H"Content-Type: application/json"\ -d '{"customer_id":"019e1a90-622b-73c7-ab65-8e65b4d55be7","biller_id":"019e1a90-622b-73c7-aaaa-bbbbcccc0001","warehouse_id":"019e1a90-622b-73c7-aaaa-bbbbcccc0002","payment_method":"cash","currency":"ARS","note":"Venta mostrador","pdf_format":"a4","items":[{"product_id":"019d9c10-a3f1-7012-bc34-58e9aa1f5d40","product_code":"PROD-001","product_name":"Yerba mate 1 kg","quantity":2,"unit_price":1500.00,"tax_rate_id":"a4a5e10a-0000-4000-8000-000000000121","tax_method":"inclusive"},{"product_name":"Servicio de envio","quantity":1,"unit_price":5000.00,"discount":"10%","tax_rate_id":"a4a5e10a-0000-4000-8000-000000000121","tax_method":"inclusive"}]}'# Respuesta HTTP 201 — la venta ya quedo facturada (CAE otorgado por ARCA):# {# "id": "019f12a3-7c4d-71b2-8d3e-aaaaaaaaaaaa",# "reference_no": "VENTA-A1B2C3",# "cfe_name": "Factura B",# "serie": "00001",# "numero": 9,# "grand_total": 7500.00,# "total": 7500.00,# "total_tax": 1301.65,# "payment_status": "paid",# "sale_status": "completed",# "billing_status": null,# "billing_status_reason": null,# "pdf_url_a4": "https://x.facturando.com/pdf/Ab3dE9",# "pdf_url_ticket": "https://x.facturando.com/pdft/Ab3dE9",# "items": [ ... ]# }# PDF: pdf_url_a4 / pdf_url_ticket abren una pagina para verlo en el navegador.# Para descargar el ARCHIVO PDF (ej. adjuntarlo a un correo) usa el codigo del# final de esa URL en la API:curl -o comprobante.pdf "https://x.facturando.com/x/api/pdf/Ab3dE9" # A4
curl -o ticket.pdf "https://x.facturando.com/x/api/pdft/Ab3dE9" # ticket
# Estado en ARCA: si ARCA rechaza el comprobante, GET /sales/:id devuelve# "sale_status": "rechazado_dgi", "billing_status": "rejected" y el motivo en# "billing_status_reason". Cada venta se envia con su propio identificador,# asi que se pueden crear ventas en paralelo.# ─── Venta por cuenta y orden de un tercero (comitente) ───────────────────────# Mismo POST /sales, pero con el biller_id del emisor del comitente (ver Emisores).# El comprobante al comprador sale con TU CUIT y tu punto de venta, queda vinculado# al comitente y el PDF lleva la leyenda "Operacion realizada por cuenta y orden de# ORGANIZADOR SA - CUIT 30-71234567-8".curl -XPOST"https://x.facturando.com/x/api/rest-api/sales"\ -H"Authorization: Bearer fct_a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6"\ -H"Content-Type: application/json"\ -d '{"customer_id":"019e1a90-622b-73c7-ab65-8e65b4d55be7","biller_id":"019e1a90-622b-73c7-aaaa-bbbbcccc0009","warehouse_id":"019e1a90-622b-73c7-aaaa-bbbbcccc0002","payment_method":"cash","items":[{"product_name":"Entrada espectaculo 15/11","quantity":2,"unit_price":12000.00,"tax_rate_id":"a4a5e10a-0000-4000-8000-000000000121","tax_method":"inclusive"}]}'# Respuesta HTTP 201: "cfe_name": "Factura B", "billing_response.comitente": { "nombre": "ORGANIZADOR SA", "cuit": "30712345678" }# Rendicion al comitente: misma llamada con el biller del comitente y el COMITENTE como cliente# (customer_id de un cliente creado con su CUIT). Se emite la Cuenta de Venta y Liquido Producto# (CfeId 60 si el comitente es Responsable Inscripto, 61 si no) por las ventas rendidas.curl -XPOST"https://x.facturando.com/x/api/rest-api/sales"\ -H"Authorization: Bearer fct_a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6"\ -H"Content-Type: application/json"\ -d '{"customer_id":"019e1a90-622b-73c7-ab65-cccccccc0009","biller_id":"019e1a90-622b-73c7-aaaa-bbbbcccc0009","warehouse_id":"019e1a90-622b-73c7-aaaa-bbbbcccc0002","payment_method":"credit","items":[{"product_name":"Ventas realizadas por su cuenta - periodo 10/2026","quantity":1,"unit_price":240000.00,"tax_rate_id":"a4a5e10a-0000-4000-8000-000000000121","tax_method":"inclusive"}]}'# Respuesta HTTP 201: "cfe_name": "Cuenta de Venta y Líquido Producto A", "billing_response.CfeId": "60",# "billing_response.es_liquido_producto": true# La comision se factura aparte: POST /sales con TU biller_id y el comitente como customer_id.
Campos de la venta
Campo
Tipo
Requerido
Descripción
customer_id
uuid
Sí
ID del cliente (ver /customers)
biller_id
uuid
Sí
ID del emisor (ver /billers). Debe tener la facturación electrónica activa
warehouse_id
uuid
Sí
ID de la sucursal (ver /warehouses)
items
array
Sí
Ítems de la venta, al menos uno (ver estructura abajo)
date
string
No
Fecha ISO (default: fecha actual)
payment_method
string
No
cash, transfer, card, cheque u other (default: cash)
paid
number
No
Monto pagado (default: el total de la venta)
currency
string
No
Código de moneda ISO (default: ARS, la moneda principal de tu cuenta)
note
string
No
Nota o comentario
pdf_format
string
No
ticket o a4 (default: a4)
reference_no
string
No
Número de referencia. Si no se envía se genera (VENTA-00001)
Estructura de cada ítem
Campo
Tipo
Requerido
Descripción
product_id
uuid
No
ID del producto. Si es null, se trata como ítem manual
product_code
string
No
Código del producto
product_name
string
Sí
Nombre del producto o servicio
quantity
number
Sí
Cantidad (default: 1)
unit_price
number
Sí
Precio unitario
discount
string
No
Descuento: "100" (fijo) o "10%" (porcentaje)
tax_rate_id
uuid
No
ID de la tasa de impuesto a aplicar (ver /tax-rates)
tax_method
string
No
"exclusive" (el impuesto se suma) o "inclusive" (impuesto incluido en el precio)
Si el ítem trae product_id, se toma como venta de un producto de tu catálogo. Si no, es un ítem manual (por ejemplo un servicio) y alcanza con product_name, quantity y unit_price.
Lógica de pago
Si no enviás paid, se asume pago total y el estado queda como paid.
Si enviás paid: 0, la venta queda como pending (sin pago).
Si enviás un monto menor al total, queda como partial (pago parcial).
Campos autogenerados
Los siguientes campos se calculan automáticamente y no deben enviarse:
reference_no: se genera solo (VENTA-00001). Si enviás uno que ya existe, se genera uno nuevo.
grand_total, total, total_tax: calculados a partir de los ítems.
payment_status: determinado según el monto pagado.
customer: nombre del cliente obtenido del customer_id.
Subtotales e impuestos de cada ítem.
serie, numero, cfe_name: se completan con la respuesta de facturación.
Respuesta del POST /sales
La respuesta incluye el ID de la venta, la respuesta de facturación electrónica (billing_response) y las URLs públicas del PDF:
Tipo de comprobante de ARCA (1 Factura A, 6 Factura B, 11 Factura C; 3, 8 y 13 son las notas de crédito A, B y C; 60 y 61 la Cuenta de Venta y Líquido Producto A y B de la venta por cuenta y orden)
billing_response.Serie
Punto de venta (5 dígitos)
billing_response.Numero
Número del comprobante dentro del punto de venta
billing_response.CfeName
Nombre del comprobante (Factura A, Factura B, Nota de Crédito B, Cuenta de Venta y Líquido Producto A…)
DataToGeneratePDF.CAE
CAE otorgado por ARCA (número y fecha de vencimiento)
DataToGeneratePDF.URLDGI
URL del código QR de ARCA para verificar el comprobante
DataToGeneratePDF.DocCodSeg
En Argentina es el mismo número de CAE
pdf_url_a4
PDF en formato A4, público, listo para enviar al cliente
pdf_url_ticket
PDF en formato ticket
Reglas de facturación electrónica
El emisor (biller_id) debe tener la integración de facturación electrónica activa. Si no la tiene, la venta no se crea y se devuelve 422.
Si la facturación electrónica responde con error, la venta se elimina automáticamente y se devuelve 502 con el detalle del error.
Solo se confirma la venta si la facturación electrónica responde exitosamente. No existen ventas "a medias".
Qué tipo de comprobante corresponde (A, B o C), qué alícuota de IVA lleva cada ítem o cómo tratar una operación exenta son definiciones fiscales, no de la API. Si tenés dudas, consultá a tu contador antes de emitir: un comprobante emitido con criterio equivocado solo se corrige con otro comprobante.
Venta por cuenta y orden de terceros
Si vendés mercadería o servicios de un tercero (el comitente: consignación, comisionista, agencia, plataforma), el comprobante al comprador lo emitís vos, con tu CUIT y tu punto de venta, y la rendición al comitente es un comprobante aparte. Facturando lo resuelve con un emisor adicional dentro de tu misma cuenta, dado de alta con el CUIT del comitente: lo configura el soporte con el CUIT, la razón social, la condición frente al IVA y el domicilio de cada comitente.
Buscá el emisor del comitente en GET /billers y usalo como biller_id en la venta. Todo lo demás (cliente, ítems, pago, IVA) es igual a una venta propia.
El comprobante sale con tu CUIT (Factura A, B o C según corresponda), queda vinculado al comitente y el PDF lleva la leyenda obligatoria de la RG 1415: Operación realizada por cuenta y orden de NOMBRE - CUIT. El web service de ARCA no tiene un campo para el comitente; la leyenda es la identificación.
Para rendirle al comitente, hacé la misma venta con el emisor del comitente y el propio comitente como customer_id (un cliente creado con su CUIT): se emite la Cuenta de Venta y Líquido Producto, CfeId 60 (letra A) o 61 (letra B), por las ventas realizadas por su cuenta. Requiere que tu empresa sea Responsable Inscripto.
La comisión se factura aparte: una Factura común desde tu emisor al CUIT del comitente. No se netea en el Líquido Producto.
Las notas de crédito de esas ventas se emiten con el mismo emisor del comitente y quedan asociadas al comprobante original.
Respuesta de una venta por cuenta y orden y de la rendición al comitente
// Venta al comprador final con el biller_id del comitente
{"id":"b80356b1-ae62-4a22-8c9b-6cadd2532179","cfe_name":"Factura B","serie":"00012","numero":10,"billing_response":{"CfeId":"6","CfeName":"Factura B","comitente":{"nombre":"ORGANIZADOR SA","cuit":"30712345678","cuit_formateado":"30-71234567-8"},"leyenda_cuenta_orden":"Operación realizada por cuenta y orden de ORGANIZADOR SA - CUIT 30-71234567-8 - IVA Responsable Inscripto","es_liquido_producto":false,"DataToGeneratePDF":{"CAE":{"CAE_ID":"86441047205466","FecVenc":"2026-11-13"}}}}
// Rendición al comitente: mismo biller_id, customer_id = el comitente
{"id":"4ab8e495-e7a5-4696-9e66-3857bc586cfd","cfe_name":"Cuenta de Venta y Líquido Producto A","serie":"00012","numero":1,"billing_response":{"CfeId":"60","CfeName":"Cuenta de Venta y Líquido Producto A","comitente":{"nombre":"ORGANIZADOR SA","cuit":"30712345678","cuit_formateado":"30-71234567-8"},"leyenda_cuenta_orden":"Operación realizada por cuenta y orden de ORGANIZADOR SA - CUIT 30-71234567-8 - IVA Responsable Inscripto","es_liquido_producto":true,"DataToGeneratePDF":{"CAE":{"CAE_ID":"86441047205479","FecVenc":"2026-11-13"}}}}
Si mandás una venta con un emisor cuyo CUIT no es el tuyo ni el de un comitente configurado, o el comitente está dado de baja, ARCA no se consulta y la API responde 502 con el código V26 en el detalle.
Consultar ventas y PDF
GET /sales devuelve por cada venta el id, la billing_response y las URLs pdf_url_a4 y pdf_url_ticket. GET /sales/:id devuelve la venta completa con sus ítems (también disponibles en /sale-items).
Las URLs de PDF son públicas y estables: podés guardarlas, enviarlas por email o WhatsApp, o mostrarlas en tu sistema.
# Crear una categoria padrecurl -XPOST"https://x.facturando.com/x/api/rest-api/categories"\ -H"Authorization: Bearer fct_a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6"\ -H"Content-Type: application/json"\ -d '{"code":"BEB","name":"Bebidas","description":"Gaseosas, aguas y jugos"}'# Crear sub-categoria (hija de la anterior)curl -XPOST"https://x.facturando.com/x/api/rest-api/categories"\ -H"Authorization: Bearer fct_a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6"\ -H"Content-Type: application/json"\ -d '{"code":"BEB-GAS","name":"Gaseosas","parent_id":"019d9c10-a3f1-7012-bc34-58e9aa1f5d20"}'
Clientes /customers
GET/customersListar todos los clientes
GET/customers/:idObtener un cliente por ID
POST/customersCrear un nuevo cliente
PUT/customers/:idActualizar un cliente
DELETE/customers/:idEliminar un cliente
Campos
Campo
Tipo
Descripción
name
string
Nombre del cliente. Si no enviás razon_social, se usa como nombre del comprador en el comprobante (auto-completado desde el CUIT si lo enviás)
razon_social
string
Razón social: es el nombre que va en el comprobante (auto-completado desde el padrón de ARCA; si no lo enviás se usa name)
nombre_fantasia
string
Nombre de fantasía (auto-completado desde el CUIT)
rut
string
CUIT del cliente (11 dígitos) o DNI del comprador (7 u 8 dígitos); puntos y guiones se quitan. También se puede enviar como tipo_documento "CUIT" o "DNI" + numero_documento. Si ya existe un cliente con ese número, NO se duplica: la API devuelve 200 con { already_exists: true, id, data } y el UUID del existente.
email
string
Correo electrónico (auto-completado desde el CUIT si no lo enviás)
phone
string
Teléfono
address
string
Domicilio fiscal (auto-completado desde el padrón de ARCA)
giro
string
Actividad principal (auto-completado desde el padrón de ARCA)
country
string
Nombre del país (default: país de la empresa)
codigo_pais
string
Código ISO del país: "AR" para Argentina (default: país de la empresa). Para un cliente del exterior, el código de su país.
city
string
Localidad (opcional)
state
string
Provincia (opcional)
tipo_documento
string
"CUIT" o "DNI". Con "CUIT", numero_documento se toma como CUIT de la empresa o persona. Con "DNI", como documento del comprador: el comprobante sale con el comprador identificado (ARCA lo exige a consumidor final por encima del monto vigente).
numero_documento
string
Número de documento, solo dígitos (CUIT de 11 dígitos o DNI). Si se envían puntos o guiones se quitan.
Al enviar el CUIT en `rut`, el endpoint consulta automáticamente el padrón de ARCA (constancia de inscripción) y completa razón social, domicilio y actividad si vienen vacíos en el payload. Si ya existe un cliente con ese número (normalizado a solo dígitos), NO se crea uno nuevo: la respuesta es **HTTP 200** con `{"already_exists": true, "id": "<uuid>", "data": {...}}`. Caso nuevo: **HTTP 201** con el registro creado. El tipo de comprobante (Factura A, B o C) lo define el sistema según la condición frente al IVA del emisor y del cliente.
Ejemplo cURL
/customers
# Crear cliente solo con CUIT — el sistema completa razon social,# domicilio y actividad consultando el padron de ARCA automaticamente.curl -XPOST"https://x.facturando.com/x/api/rest-api/customers"\ -H"Authorization: Bearer fct_a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6"\ -H"Content-Type: application/json"\ -d '{"rut":"30712345671"}'# Respuesta HTTP 201 (creado):# {# "id": "019f12a3-7c4d-71b2-8d3e-4a5b6c7d8e9f",# "name": "COMERCIAL EJEMPLO SA",# "razon_social": "COMERCIAL EJEMPLO SA",# "rut": "30712345671",# "address": "AV CORRIENTES 1234, CIUDAD AUTONOMA BUENOS AIRES",# "giro": "VENTA AL POR MAYOR DE MERCANCIAS N.C.P.",# "country": "AR",# "codigo_pais": "AR",# ...# }# Respuesta HTTP 200 (el CUIT ya existe — NO se duplica):# {# "already_exists": true,# "id": "019e1a90-622b-73c7-ab65-8e65b4d55be7",# "message": "Ya existe un cliente con ese RUT.",# "data": { "id": "019e1a90-622b-73c7-ab65-8e65b4d55be7", "rut": "30712345671", ... }# }# Crear cliente persona con DNI (comprador identificado en la Factura B).# El DNI va solo con digitos:curl -XPOST"https://x.facturando.com/x/api/rest-api/customers"\ -H"Authorization: Bearer fct_a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6"\ -H"Content-Type: application/json"\ -d '{"name":"Juan Perez","tipo_documento":"DNI","numero_documento":"30123456","email":"[email protected]","phone":"1155551234","address":"Av. Rivadavia 5000, CABA"}'
Proveedores /suppliers
GET/suppliersListar todos los proveedores
GET/suppliers/:idObtener un proveedor por ID
POST/suppliersCrear un nuevo proveedor
PUT/suppliers/:idActualizar un proveedor
DELETE/suppliers/:idEliminar un proveedor
Campos
Campo
Tipo
Descripción
name
string
Nombre del proveedor (auto-completado desde el CUIT)
razon_social
string
Razón social (auto-completado desde el CUIT)
rut
string
CUIT del proveedor — dedup automático: si ya existe, devuelve `{already_exists: true, id, data}` con HTTP 200.
email
string
Correo electrónico
phone
string
Teléfono
address
string
Domicilio fiscal (auto-completado desde el CUIT)
Al enviar el CUIT en `rut`, mismo comportamiento que /customers: auto-completado con datos del padrón de ARCA + dedup por CUIT.
GET/billers/:idObtener un emisor por ID (solo lectura)
Campos
Campo
Tipo
Descripción
id
uuid
UUID del emisor (usar en biller_id al crear ventas)
name
string
Nombre comercial
razon_social
string
Razon social
rut
string
CUIT del emisor. Un emisor dado de alta con el CUIT de un comitente (un tercero por cuya cuenta vendés) es el que se usa para la venta por cuenta y orden: ver la nota.
Venta por cuenta y orden de terceros (RG 1415): si vendés mercadería o servicios de un tercero (el **comitente**: consignación, comisionista, agencia, plataforma), Facturando lo maneja con un **emisor aparte dentro de tu misma cuenta**, dado de alta con el CUIT y la razón social del comitente y la misma facturación electrónica que tu emisor. Lo configura el soporte de Facturando: nos pasás el CUIT, la razón social, la condición frente al IVA y el domicilio de cada comitente. En la API aparece en `GET /billers` como un emisor más; usalo como `biller_id` en `POST /sales` y `POST /credit-notes` para las ventas por cuenta de ese comitente. El comprobante al comprador sale igual con **tu** CUIT y tu punto de venta (el web service de ARCA no identifica al comitente) y lleva la leyenda obligatoria "Operación realizada por cuenta y orden de … CUIT …".
Ejemplo cURL
/billers
curl -XGET"https://x.facturando.com/x/api/rest-api/billers"\ -H"Authorization: Bearer fct_a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6"# Respuesta: el emisor propio y, si vendés por cuenta de terceros, un emisor por cada comitente# {# "data": [# {# "id": "019e1a90-622b-73c7-aaaa-bbbbcccc0001",# "name": "Casa Central",# "razon_social": "MI EMPRESA SRL",# "rut": "30709876542"# },# {# "id": "019e1a90-622b-73c7-aaaa-bbbbcccc0009",# "name": "Por cuenta y orden de ORGANIZADOR SA",# "razon_social": "ORGANIZADOR SA",# "rut": "30712345678"# }# ],# "meta": { "total": 2, "page": 1, "per_page": 25 }# }
GET/sales/:idObtener una venta por ID, con su estado: sale_status ("rechazado_dgi" si ARCA la rechazó), billing_status ("rejected") y billing_status_reason (motivo)
POST/salesCrear una venta completa (factura)
Campos
Campo
Tipo
Descripción
customer_id
uuid
ID del cliente (requerido al crear). Para identificar al comprador (CUIT o DNI) ver Clientes; sin identificar, la factura sale a Consumidor Final.
biller_id
uuid
ID del emisor (requerido). Tu emisor para las ventas propias; el emisor del comitente (ver Emisores) para una venta por cuenta y orden de ese tercero: el comprobante sale con tu CUIT, vinculado al comitente y con la leyenda "por cuenta y orden de" en el PDF.
warehouse_id
uuid
ID de la sucursal (requerido al crear)
reference_no
string
Número de referencia (auto-generado si vacío)
date
string
Fecha ISO (default: fecha actual)
payment_method
string
cash, transfer, card, cheque, other (default: cash)
paid
number
Monto pagado (default: grand_total)
currency
string
Código de moneda ISO (default: ARS)
note
string
Nota o comentario
pdf_format
string
ticket o a4 (default: a4)
items
array
Array de items de la venta (requerido al crear). Cada item necesita su tax_rate_id — ver GET /tax-rates
Venta por cuenta y orden de terceros: con el `biller_id` del comitente la venta al comprador final se factura igual que una propia (Factura A, B o C con tu CUIT y tu punto de venta) y el PDF lleva la leyenda de la RG 1415 con los datos del comitente. Si en esa misma venta el `customer_id` es el **propio comitente** (cliente con su CUIT), el comprobante que se emite es la **Cuenta de Venta y Líquido Producto** (`CfeId` 60 letra A o 61 letra B): la rendición de las ventas realizadas por su cuenta. Requiere que tu empresa sea Responsable Inscripto. La comisión se factura aparte, con una Factura común desde tu emisor al CUIT del comitente; no se netea en el Líquido Producto.
Ejemplo cURL
/sales
# Crear venta con facturacion electronica automaticacurl -XPOST"https://x.facturando.com/x/api/rest-api/sales"\ -H"Authorization: Bearer fct_a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6"\ -H"Content-Type: application/json"\ -d '{"customer_id":"019e1a90-622b-73c7-ab65-8e65b4d55be7","biller_id":"019e1a90-622b-73c7-aaaa-bbbbcccc0001","warehouse_id":"019e1a90-622b-73c7-aaaa-bbbbcccc0002","payment_method":"cash","currency":"ARS","note":"Venta mostrador","pdf_format":"a4","items":[{"product_id":"019d9c10-a3f1-7012-bc34-58e9aa1f5d40","product_code":"PROD-001","product_name":"Yerba mate 1 kg","quantity":2,"unit_price":1500.00,"tax_rate_id":"a4a5e10a-0000-4000-8000-000000000121","tax_method":"inclusive"},{"product_name":"Servicio de envio","quantity":1,"unit_price":5000.00,"discount":"10%","tax_rate_id":"a4a5e10a-0000-4000-8000-000000000121","tax_method":"inclusive"}]}'# Respuesta HTTP 201 — la venta ya quedo facturada (CAE otorgado por ARCA):# {# "id": "019f12a3-7c4d-71b2-8d3e-aaaaaaaaaaaa",# "reference_no": "VENTA-A1B2C3",# "cfe_name": "Factura B",# "serie": "00001",# "numero": 9,# "grand_total": 7500.00,# "total": 7500.00,# "total_tax": 1301.65,# "payment_status": "paid",# "sale_status": "completed",# "billing_status": null,# "billing_status_reason": null,# "pdf_url_a4": "https://x.facturando.com/pdf/Ab3dE9",# "pdf_url_ticket": "https://x.facturando.com/pdft/Ab3dE9",# "items": [ ... ]# }# PDF: pdf_url_a4 / pdf_url_ticket abren una pagina para verlo en el navegador.# Para descargar el ARCHIVO PDF (ej. adjuntarlo a un correo) usa el codigo del# final de esa URL en la API:curl -o comprobante.pdf "https://x.facturando.com/x/api/pdf/Ab3dE9" # A4
curl -o ticket.pdf "https://x.facturando.com/x/api/pdft/Ab3dE9" # ticket
# Estado en ARCA: si ARCA rechaza el comprobante, GET /sales/:id devuelve# "sale_status": "rechazado_dgi", "billing_status": "rejected" y el motivo en# "billing_status_reason". Cada venta se envia con su propio identificador,# asi que se pueden crear ventas en paralelo.# ─── Venta por cuenta y orden de un tercero (comitente) ───────────────────────# Mismo POST /sales, pero con el biller_id del emisor del comitente (ver Emisores).# El comprobante al comprador sale con TU CUIT y tu punto de venta, queda vinculado# al comitente y el PDF lleva la leyenda "Operacion realizada por cuenta y orden de# ORGANIZADOR SA - CUIT 30-71234567-8".curl -XPOST"https://x.facturando.com/x/api/rest-api/sales"\ -H"Authorization: Bearer fct_a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6"\ -H"Content-Type: application/json"\ -d '{"customer_id":"019e1a90-622b-73c7-ab65-8e65b4d55be7","biller_id":"019e1a90-622b-73c7-aaaa-bbbbcccc0009","warehouse_id":"019e1a90-622b-73c7-aaaa-bbbbcccc0002","payment_method":"cash","items":[{"product_name":"Entrada espectaculo 15/11","quantity":2,"unit_price":12000.00,"tax_rate_id":"a4a5e10a-0000-4000-8000-000000000121","tax_method":"inclusive"}]}'# Respuesta HTTP 201: "cfe_name": "Factura B", "billing_response.comitente": { "nombre": "ORGANIZADOR SA", "cuit": "30712345678" }# Rendicion al comitente: misma llamada con el biller del comitente y el COMITENTE como cliente# (customer_id de un cliente creado con su CUIT). Se emite la Cuenta de Venta y Liquido Producto# (CfeId 60 si el comitente es Responsable Inscripto, 61 si no) por las ventas rendidas.curl -XPOST"https://x.facturando.com/x/api/rest-api/sales"\ -H"Authorization: Bearer fct_a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6"\ -H"Content-Type: application/json"\ -d '{"customer_id":"019e1a90-622b-73c7-ab65-cccccccc0009","biller_id":"019e1a90-622b-73c7-aaaa-bbbbcccc0009","warehouse_id":"019e1a90-622b-73c7-aaaa-bbbbcccc0002","payment_method":"credit","items":[{"product_name":"Ventas realizadas por su cuenta - periodo 10/2026","quantity":1,"unit_price":240000.00,"tax_rate_id":"a4a5e10a-0000-4000-8000-000000000121","tax_method":"inclusive"}]}'# Respuesta HTTP 201: "cfe_name": "Cuenta de Venta y Líquido Producto A", "billing_response.CfeId": "60",# "billing_response.es_liquido_producto": true# La comision se factura aparte: POST /sales con TU biller_id y el comitente como customer_id.
Notas de Crédito /credit-notes
GET/credit-notesListar notas de crédito emitidas
GET/credit-notes/:idObtener una nota de crédito por ID
POST/credit-notesEmitir una nota de crédito (parcial o por cualquier importe). Se pueden emitir varias NC parciales contra la misma venta (una por cada anulación parcial)
POST/sales/:id/voidAnular una venta completa: emite la NC por el total y repone el stock (una sola vez por venta: después responde "Esta venta ya tiene una nota de crédito asociada")
Campos
Campo
Tipo
Descripción
customer_id
uuid
ID del cliente (requerido)
biller_id
uuid
ID del emisor (requerido)
warehouse_id
uuid
ID de la sucursal (requerido)
items
array
Ítems a acreditar, con importes en POSITIVO (requerido). Cada ítem necesita su tax_rate_id — ver GET /tax-rates
reference_sale_id
uuid
Venta del sistema que se acredita: toma su tipo, punto de venta, número y fecha (comprobante asociado), y la NC descuenta el saldo de esa factura. Se pueden emitir varias NC parciales con la misma venta. Si ARCA todavía no autorizó esa venta, responde 422: reintentá más tarde.
reference
object
Referencia manual a un comprobante que no está en el sistema: { doc_type (código ARCA: 1 Factura A, 6 Factura B, 11 Factura C), serie (punto de venta), numero, date }
reason
string
Razón. Sin reference_sale_id ni reference se emite como referencia global (sin documento)
date
string
Fecha ISO (default: la de la venta referenciada, o la fecha actual)
currency
string
Código de moneda ISO (default: el de la venta referenciada, o ARS)
note
string
Nota o comentario del comprobante
pdf_format
string
ticket o a4 (default: a4)
Las notas de crédito de una venta por cuenta y orden se emiten con el mismo `biller_id` del comitente que usó la venta (ver Emisores): salen con tu CUIT, asociadas al comprobante original y con la misma leyenda.
Ejemplo cURL
/credit-notes
# 1) NC relacionada a una factura del sistema (descuenta su saldo)curl -XPOST"https://x.facturando.com/x/api/rest-api/credit-notes"\ -H"Authorization: Bearer fct_a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6"\ -H"Content-Type: application/json"\ -d '{"customer_id":"019e1a90-622b-73c7-ab65-8e65b4d55be7","biller_id":"019e1a90-622b-73c7-aaaa-bbbbcccc0001","warehouse_id":"019e1a90-622b-73c7-aaaa-bbbbcccc0002","reference_sale_id":"019f12a3-7c4d-71b2-8d3e-aaaaaaaaaaaa","reason":"Devolucion de 1 unidad","note":"Nota de credito manual","items":[{"product_name":"Yerba mate 1 kg","quantity":1,"unit_price":1500.00,"tax_rate_id":"a4a5e10a-0000-4000-8000-000000000121","tax_method":"inclusive"}]}'# 2) NC contra un comprobante que no esta en el sistema (comprobante asociado manual:# doc_type = codigo ARCA del comprobante, serie = punto de venta)curl -XPOST"https://x.facturando.com/x/api/rest-api/credit-notes"\ -H"Authorization: Bearer fct_a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6"\ -H"Content-Type: application/json"\ -d '{"customer_id":"019e1a90-622b-73c7-ab65-8e65b4d55be7","biller_id":"019e1a90-622b-73c7-aaaa-bbbbcccc0001","warehouse_id":"019e1a90-622b-73c7-aaaa-bbbbcccc0002","reference":{"doc_type":"6","serie":"00001","numero":"8561","date":"2026-06-08"},"note":"Nota de credito manual","items":[{"product_name":"Ajuste de precio","quantity":1,"unit_price":6418.20,"tax_method":"inclusive"}]}'# 3) NC con razon global (sin comprobante asociado)curl -XPOST"https://x.facturando.com/x/api/rest-api/credit-notes"\ -H"Authorization: Bearer fct_a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6"\ -H"Content-Type: application/json"\ -d '{"customer_id":"019e1a90-622b-73c7-ab65-8e65b4d55be7","biller_id":"019e1a90-622b-73c7-aaaa-bbbbcccc0001","warehouse_id":"019e1a90-622b-73c7-aaaa-bbbbcccc0002","reason":"Bonificacion comercial acordada","note":"Nota de credito manual","items":[{"product_name":"Bonificacion","quantity":1,"unit_price":12000.00,"tax_method":"inclusive"}]}'# Respuesta HTTP 201 (la NC ya quedo autorizada por ARCA, importes en negativo):# {# "id": "019f2b40-1122-7333-9aaa-bbbbbbbbbbbb",# "reference_no": "NC-00042",# "cfe_name": "Nota de Crédito B",# "serie": "00001",# "numero": 3,# "grand_total": -1500.00,# "pdf_url_a4": "https://x.facturando.com/sale/019f2b40.../pdf/a4"# }# 4) ANULAR UNA VENTA COMPLETA — equivale al boton "Anular venta"# Emite la NC por el total, asocia la factura original, repone el stock# y deja la venta marcada como anulada. No lleva body.curl -XPOST"https://x.facturando.com/x/api/rest-api/sales/019f12a3-7c4d-71b2-8d3e-aaaaaaaaaaaa/void"\ -H"Authorization: Bearer fct_a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6"# Respuesta HTTP 201:# {# "voided_sale_id": "019f12a3-7c4d-71b2-8d3e-aaaaaaaaaaaa",# "credit_note": {# "id": "019f2b41-...", "reference_no": "NC-00043",# "cfe_name": "Nota de Crédito B", "serie": "00001", "numero": 4,# "grand_total": -7500.00# }# }# Errores frecuentes:# 404 La venta de reference_sale_id no existe# 422 Esta venta ya tiene una nota de credito asociada, esta devuelta o rechazada por ARCA# 422 El emisor no tiene la facturacion electronica activa# 403 DELETE no esta permitido: las NC no se borran, se anulan
Items de Venta /sale-items
GET/sale-itemsListar items de ventas
GET/sale-items/:idObtener un item por ID
Campos
Campo
Tipo
Descripción
sale_id
uuid
ID de la venta
product_id
uuid
ID del producto (null si es manual)
product_code
string
Código del producto
product_name
string
Nombre del producto
quantity
number
Cantidad vendida
unit_price
number
Precio unitario
discount
string
Descuento aplicado (valor fijo o porcentaje con %)
item_tax
number
Impuesto calculado del item
subtotal
number
Subtotal del item
tax_rate_id
uuid
ID de la tasa de impuesto
tax_method
string
exclusive o inclusive (default: exclusive)
Ejemplo cURL
/sale-items
# Listar los items de una venta especificacurl -XGET"https://x.facturando.com/x/api/rest-api/sale-items?sale_id=019f12a3-7c4d-71b2-8d3e-aaaaaaaaaaaa"\ -H"Authorization: Bearer fct_a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6"
# Stock de todos los productos en todas las sucursalescurl -XGET"https://x.facturando.com/x/api/rest-api/stock?page=1&per_page=100"\ -H"Authorization: Bearer fct_a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6"# Stock de un producto en particularcurl -XGET"https://x.facturando.com/x/api/rest-api/stock?product_id=019d9c10-a3f1-7012-bc34-58e9aa1f5d40"\ -H"Authorization: Bearer fct_a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6"
Monedas (solo lectura) /currencies
GET/currenciesListar todas las monedas
GET/currencies/:idObtener una moneda por ID
Campos
Campo
Tipo
Descripción
code
string
Código de la moneda (ej: ARS, USD)
name
string
Nombre de la moneda
symbol
string
Simbolo de la moneda (ej: $, US$)
rate
number
Tasa de cambio
is_default
boolean
Si es la moneda por defecto
Ejemplo cURL
/currencies
curl -XGET"https://x.facturando.com/x/api/rest-api/currencies"\ -H"Authorization: Bearer fct_a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6"# Respuesta (la moneda principal de tu cuenta es ARS):# {# "data": [# { "id": "...", "code": "ARS", "name": "Peso Argentino", "symbol": "$", ... },# { "id": "...", "code": "USD", "name": "Dolar Estadounidense", "symbol": "US$", ... }# ],# "meta": { "total": 2, "page": 1, "per_page": 25 }# }
Impuestos (solo lectura) /tax-rates
GET/tax-ratesListar todas las tasas de impuesto
GET/tax-rates/:idObtener una tasa de impuesto por ID
Campos
Campo
Tipo
Descripción
code
string
Código de la tasa de impuesto
name
string
Nombre del impuesto (ej: IVA 21% (AR))
rate
number
Porcentaje del impuesto
ind_fact_id
string
Id de alícuota de IVA de ARCA: 5 = 21 %, 4 = 10,5 %, 6 = 27 %, 3 = 0 %, 2 = exento, 1 = no gravado
Error en la solicitud (datos inválidos o campo requerido faltante)
401
Token inválido, inactivo o expirado
403
Operación no permitida en este recurso
404
Recurso o registro no encontrado
405
Método HTTP no soportado (por ejemplo, POST sobre un recurso de solo lectura)
422
El emisor no tiene la facturación electrónica activa: la venta no se crea
502
ARCA rechazó el comprobante: la venta se elimina y se devuelve el detalle
500
Error interno. La respuesta incluye un request_id para citar al soporte
Límites y buenas prácticas
Máximo 100 resultados por página en los listados.
Todas las solicitudes quedan registradas para auditoría (endpoint, código y duración).
Usá un token por integración y ponele fecha de expiración; revocalo si se filtra.
Antes de crear un cliente, buscalo por CUIT: el endpoint no duplica y te devuelve el existente.
Guardá el id de la venta y las URLs de PDF que devuelve el POST /sales; son tu comprobante de la operación.
Ante un 502 revisá el detalle antes de reintentar: suele ser un dato del cliente o del ítem que ARCA rechaza.
Soporte
¿Algo no cierra o necesitás un campo que no está acá? Escribinos a [email protected] con el request_id si lo tenés, o hablanos por WhatsApp al +54 9 11 6009 2102.