> ## Documentation Index > Fetch the complete documentation index at: https://docs.facture.ar/llms.txt > Use this file to discover all available pages before exploring further. # 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). ## OpenAPI ````yaml /openapi.json post /documents openapi: 3.1.0 info: title: Facturear API description: >- API para emitir facturas electrónicas de ARCA (Argentina) desde tu sistema: facturas, notas de crédito y débito, lotes, PDF y XML, envío por email, borradores desde documentos, webhooks y reportes. Autenticación con API Key en el header x-api-key: la key de testing opera en homologación y la de producción emite comprobantes reales. version: 1.0.0 contact: name: Facturear Support email: support@facture.ar url: https://facture.ar license: name: MIT url: https://opensource.org/licenses/MIT servers: - url: https://www.facture.ar/api description: Servidor de producción security: - apiKey: [] tags: - name: CUITs description: CUITs emisores, sus defaults, puntos de venta y diseño - name: Facturas description: Emitir, listar y consultar facturas, su PDF y XML, y enviarlas por email - name: Lotes description: 'El resultado de cada emisión: toda factura se procesa en un lote' - name: Borradores description: >- Facturas propuestas desde documentos, planillas o datos, para revisar y emitir - name: Plantillas description: Cómo se lee y se factura cada tipo de documento, y facturas recurrentes - name: Importar desde ARCA description: Traer a Facturear los comprobantes que ARCA ya autorizó - name: Webhooks description: Notificaciones a tu sistema cuando pasa algo con tus facturas - name: Reportes description: Libro IVA Ventas - name: Utilidades description: Parámetros de ARCA paths: /documents: post: tags: - Borradores summary: Proponer facturas desde un documento description: >- 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). parameters: - $ref: '#/components/parameters/IdempotencyKey' requestBody: required: true content: application/json: schema: type: object properties: templateId: type: - string - 'null' description: >- Plantilla que define CUIT, punto de venta, modo, cliente fijo, precios e instrucciones mode: type: string enum: - manual - automatic description: 'automatic: se emite solo si no hay observaciones' cuitId: type: - string - 'null' ptoVta: type: - integer - 'null' minimum: 1 dedupeKey: type: - string - 'null' maxLength: 200 description: >- Id estable del documento: repetir el pedido con el mismo valor no duplica el borrador sourceRef: type: - string - 'null' maxLength: 200 description: Referencia que se muestra en el borrador source: type: string enum: - api - zapier - mcp default: api fileUrl: type: string format: uri description: URL pública del archivo (PDF, imagen o planilla) fileName: type: string maxLength: 200 mimeType: type: string text: type: string description: Texto del documento (un pedido, un mensaje) data: oneOf: - $ref: '#/components/schemas/DraftData' - type: array minItems: 1 maxItems: 100 items: $ref: '#/components/schemas/DraftData' multipart/form-data: schema: type: object required: - file properties: file: type: string format: binary description: Hasta 25 MB templateId: type: - string - 'null' description: >- Plantilla que define CUIT, punto de venta, modo, cliente fijo, precios e instrucciones mode: type: string enum: - manual - automatic description: 'automatic: se emite solo si no hay observaciones' cuitId: type: - string - 'null' ptoVta: type: - integer - 'null' minimum: 1 dedupeKey: type: - string - 'null' maxLength: 200 description: >- Id estable del documento: repetir el pedido con el mismo valor no duplica el borrador sourceRef: type: - string - 'null' maxLength: 200 description: Referencia que se muestra en el borrador source: type: string enum: - api - zapier - mcp default: api responses: '202': description: Borradores creados headers: Idempotent-Replayed: $ref: '#/components/headers/IdempotentReplayed' content: application/json: schema: type: object properties: drafts: type: array items: $ref: '#/components/schemas/Draft' mapping: type: object description: >- Solo planillas: las columnas usadas y si la IA las acaba de proponer '400': description: Falta el documento o los datos son inválidos content: application/json: schema: $ref: '#/components/schemas/Error' '409': $ref: '#/components/responses/IdempotencyInProgress' '422': $ref: '#/components/responses/IdempotencyKeyReused' components: parameters: IdempotencyKey: name: Idempotency-Key in: header required: false description: >- 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 `:`. schema: type: string minLength: 1 maxLength: 255 example: 6f1c2b0e-8a43-4c5e-9d2a-3b7f1e0c9a11 schemas: DraftData: type: object description: Los datos de la factura propuesta required: - lines properties: receiver: type: object properties: name: type: - string - 'null' maxLength: 200 docType: type: - string - 'null' description: CUIT, CUIL o DNI; null = consumidor final sin identificar docNumber: type: - string - 'null' description: CUIT, CUIL o DNI, con o sin guiones condicionIva: type: - integer - 'null' description: >- Condición frente al IVA del receptor (código de ARCA). Si falta, se busca en el padrón email: type: - string - 'null' format: email description: Si está, se le manda la factura address: type: - string - 'null' maxLength: 300 concepto: type: integer enum: - 1 - 2 - 3 default: 1 description: 1 productos, 2 servicios, 3 productos y servicios serviceFrom: type: - string - 'null' format: date description: AAAA-MM-DD, servicios serviceTo: type: - string - 'null' format: date description: AAAA-MM-DD, servicios paymentDue: type: - string - 'null' format: date description: Vencimiento del pago, AAAA-MM-DD pricesIncludeIva: type: boolean default: true description: Los precios de las líneas incluyen IVA lines: type: array maxItems: 200 items: type: object required: - description - unitPrice properties: description: type: string maxLength: 200 quantity: type: number exclusiveMinimum: 0 default: 1 unitPrice: type: - number - 'null' minimum: 0 description: null si el documento no trae precio ivaRate: type: number enum: - 0 - 2.5 - 5 - 10.5 - 21 - 27 default: 21 description: Alícuota de IVA en porcentaje documentTotal: type: - number - 'null' description: Total impreso en el documento, para controlar las líneas currency: type: string minLength: 3 maxLength: 3 default: ARS description: Moneda ISO 4217 documentDate: type: - string - 'null' format: date description: >- Fecha del documento, AAAA-MM-DD. La factura se emite con la fecha del día reference: type: - string - 'null' maxLength: 100 description: Número de remito, pedido o referencia description: type: - string - 'null' maxLength: 500 description: Texto libre que va en la factura Draft: type: object description: >- Un borrador de factura armado desde un documento, una planilla, datos enviados por API o una plantilla recurrente properties: id: type: string status: type: string enum: - extracting - review - queued - invoiced - error - discarded description: >- extracting: leyéndose; review: espera revisión; queued: enviado a ARCA; invoiced: facturado; error: no se pudo leer o emitir; discarded: descartado mode: type: string enum: - manual - automatic description: 'automatic: se emite solo si no hay observaciones' source: type: string enum: - upload - google_drive - zapier - api - recurring - mcp - whatsapp sourceRef: type: - string - 'null' fileName: type: - string - 'null' mimeType: type: - string - 'null' hasFile: type: boolean templateId: type: - string - 'null' templateName: type: - string - 'null' cuitId: type: - string - 'null' ptoVta: type: - integer - 'null' environment: type: string enum: - production - homologation data: oneOf: - $ref: '#/components/schemas/DraftData' - type: 'null' total: type: - number - 'null' description: Total calculado con las líneas; null si falta algún precio voucherLetter: type: - string - 'null' enum: - A - B - C - null confidence: type: - number - 'null' description: Confianza de la lectura con IA, de 0 a 1 issues: type: array description: Observaciones que hay que revisar items: type: object properties: code: type: string enum: - no_cuit - no_lines - missing_price - invalid_amount - total_mismatch - invalid_document - unidentified_receiver - foreign_currency - low_confidence - possible_duplicate - ai_note - ai_info message: type: string errorMessage: type: - string - 'null' invoice: type: - object - 'null' description: La factura emitida desde el borrador properties: id: type: string voucherNumber: type: integer ptoVta: type: - integer - 'null' invoiceType: type: - integer - 'null' status: type: string amount: type: number emailStatus: type: - string - 'null' description: Estado del envío de la factura por email url: type: string description: Link al borrador en el dashboard createdAt: type: string format: date-time updatedAt: type: string format: date-time Error: type: object description: >- Error de la API. Los errores de autenticación (401), validación (400), CUIT inexistente (404), conflicto (409) e internos (500) vienen como application/problem+json (RFC 9457) con code, message y resolution. Otros errores vienen como JSON con error y, a veces, details y code. En los dos casos está el campo error. required: - error properties: error: type: string description: Mensaje de error code: type: string description: >- Código estable: unauthorized, invalid_request, cuit_not_found, conflict, internal_error, o códigos propios como SUBSCRIPTION_LIMIT_EXCEEDED message: type: string description: Qué pasó (problem+json) resolution: type: string description: Qué hacer para resolverlo (problem+json) type: type: string format: uri description: URI del tipo de problema (problem+json) title: type: string description: Título corto del problema (problem+json) status: type: integer description: Código HTTP (problem+json) detail: type: string description: Igual que message (problem+json) details: description: 'Detalle del error: un texto, o la lista de errores de validación' headers: IdempotentReplayed: description: >- `true` cuando la respuesta es la guardada de una solicitud anterior con el mismo `Idempotency-Key`: no se encoló nada nuevo. schema: type: string enum: - 'true' responses: IdempotencyInProgress: description: >- Ya hay una solicitud en curso con este `Idempotency-Key` (code `IDEMPOTENCY_KEY_IN_PROGRESS`). Esperá unos segundos y reintentá con la misma clave para recibir su resultado. content: application/json: schema: $ref: '#/components/schemas/Error' IdempotencyKeyReused: description: >- Este `Idempotency-Key` ya se usó con otra solicitud: otro cuerpo u otro endpoint (code `IDEMPOTENCY_KEY_REUSED`). Usá una clave nueva para una factura distinta. content: application/json: schema: $ref: '#/components/schemas/Error' securitySchemes: apiKey: type: apiKey in: header name: x-api-key description: >- API Key para autenticación. Formato: test_sk_xxx para testing, prod_sk_xxx para producción. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.