Borradores

Proponer facturas desde un documento

Arma borradores de factura a partir de un archivo (fileUrl, o multipart con el campo file), un texto (text) o los datos ya estructurados (data, uno o hasta 100). Los archivos y textos se leen con IA en segundo plano: los borradores vuelven con status extracting; consultalos con GET /documents/drafts. El entorno lo fija la API key. Las solicitudes JSON aceptan Idempotency-Key: un reenvío devuelve los mismos borradores en vez de crear otros (ni, en modo automático, emitir otra factura).

post/documents

Request

  • Base URL: https://www.facture.ar/api
  • URL: https://www.facture.ar/api/documents
  • Auth: API key in header x-api-key

Headers

Idempotency-Keystring

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>.

Request body

templateIdstring nullable

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

mode'manual' | 'automatic'

automatic: se emite solo si no hay observaciones

cuitIdstring nullable
ptoVtainteger nullable
dedupeKeystring nullable

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

sourceRefstring nullable

Referencia que se muestra en el borrador

source'api' | 'zapier' | 'mcp'
fileUrlstring uri

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

fileNamestring
mimeTypestring
textstring

Texto del documento (un pedido, un mensaje)

Response

Borradores creados

mappingobject

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

Changes

No recorded changes to this operation across all 1 revision of this API.