Skip to main content

Integrar Facturear con tu e-commerce

Si vendés online, Facturear puede traer las ventas de tu tienda y facturarlas: todas solas apenas se pagan, o las que vos elijas después de revisarlas. Para las plataformas más usadas no tenés que programar nada: se conectan desde Integraciones. Si tu tienda es propia o usa otra plataforma, integrás con la API.

Plataformas que se conectan desde Integraciones

Tiendanube, Shopify y WooCommerce avisan a Facturear en cada pedido pagado, por eso el modo automático factura al instante. VTEX y Magento no mandan avisos: Facturear revisa los pedidos una vez por hora.

Conectar tu tienda

Automática, por WhatsApp o manual

  • Automática: cada pedido pagado se factura solo. Aplica a lo que entra desde que la activás; lo anterior lo facturás a mano.
  • Confirmar por WhatsApp: cada pedido pagado te llega al WhatsApp vinculado para que lo factures o lo marques como no facturable desde el chat, y el PDF te vuelve ahí. Ver WhatsApp.
  • Manual: importás los pedidos de un período, los revisás y elegís cuáles facturar. Sirve si no todo lo que vendés se factura igual.
Lo podés cambiar cuando quieras. Las ventas de todas tus integraciones, las que esperan revisión y las que se facturaron solas, las ves en Facturación → Ventas. Ver Ventas.

Cómo arma la factura

Facturear toma los precios de la tienda como finales y separa el neto y el IVA con la alícuota que elegiste. Si el comprador dejó un CUIT y es responsable inscripto o monotributista, sale Factura A; si no, Factura B. Si tu CUIT es monotributista, sale Factura C. El envío se suma como un ítem más.
Si conectás WooCommerce y el firewall del sitio bloquea a Facturear, mirá WooCommerce: el firewall de la tienda bloquea a Facturear.

Otras plataformas: la API

Si tu tienda no está en la lista, tu sistema llama a la API de Facturear cuando se confirma cada venta. Flujo típico:
La API encola la factura y responde enseguida con un batchId, sin CAE. Para completar la orden con el CAE, el número de comprobante y el PDF, consultá el lote en GET https://www.facture.ar/api/invoices/batches/{batchId} o suscribite a invoice.completed/invoice.failed con webhooks: invoice.completed trae el CAE, el número y el invoice.id. Con el invoiceId del resultado descargás el PDF en GET https://www.facture.ar/api/invoices/{invoiceId}/pdf.
Si el cliente informa un CUIT y no mandás condicionIVAReceptorId, Facturear la toma del padrón de ARCA. Si no corresponde a la clase del comprobante, la API responde 400. Ver Condición frente al IVA del receptor.

Manejo de datos del cliente para determinar la factura

Una buena integración de e-commerce le pide al cliente sus datos fiscales al hacer el checkout:

Manejo de errores en producción

Las integraciones de e-commerce deben manejar los casos donde la facturación falla. Hay dos momentos: la API puede rechazar el pedido al enviarlo (400 con error y details si los datos no son válidos, 403 con SUBSCRIPTION_LIMIT_EXCEEDED si superaste el límite del plan), o ARCA puede rechazar el comprobante cuando se procesa (el ítem del lote queda en status: "error").

Facturación en lotes para reconciliación

Si tu e-commerce tiene alto volumen y no querés facturar en tiempo real, podés usar la API de lotes para emitir facturas en batch una vez al día o por hora.

Recursos relacionados


Integrá tu e-commerce con Facturear

Conectá tu tienda desde Integraciones o con la API y facturá cada venta sin cargarla a mano.