Skip to main content
POST
Proponer facturas desde un documento

Authorizations

x-api-key
string
header
required

API Key para autenticación. Formato: test_sk_xxx para testing, prod_sk_xxx para producción.

Headers

Idempotency-Key
string

Clave que elegís vos (recomendado: un UUID nuevo por cada factura o lote). Si reenviás la misma solicitud con la misma clave —por un timeout, un error de red o un 5xx— recibís la respuesta original (mismo batchId, header Idempotent-Replayed: true) en vez de una factura nueva. Para una factura distinta, o después de que ARCA rechazó la anterior en forma definitiva, usá una clave nueva. Entre 1 y 255 caracteres ASCII imprimibles; se guarda 7 días. En un lote, el ítem i queda identificado como <clave>:<i>.

Required string length: 1 - 255

Body

templateId
string | null

Plantilla que define CUIT, punto de venta, modo, cliente fijo, precios e instrucciones

mode
enum<string>

automatic: se emite solo si no hay observaciones

Available options:
manual,
automatic
cuitId
string | null
ptoVta
integer | null
Required range: x >= 1
dedupeKey
string | null

Id estable del documento: repetir el pedido con el mismo valor no duplica el borrador

Maximum string length: 200
sourceRef
string | null

Referencia que se muestra en el borrador

Maximum string length: 200
source
enum<string>
default:api
Available options:
api,
zapier,
mcp
fileUrl
string<uri>

URL pública del archivo (PDF, imagen o planilla)

fileName
string
Maximum string length: 200
mimeType
string
text
string

Texto del documento (un pedido, un mensaje)

data
object

Los datos de la factura propuesta

Response

Borradores creados

drafts
object[]
mapping
object

Solo planillas: las columnas usadas y si la IA las acaba de proponer