Facturar guías de despacho

Cuando despachas con guía de despacho electrónica (tipo 52), la factura tiene que emitirse después indicando el número y la fecha de cada guía. El art. 55 de la Ley de IVA permite postergarla hasta el día 10 del mes siguiente, con fecha del período en que se hizo la venta.

Folyo arma esa factura por ti: toma el receptor y el detalle desde las guías, agrega una referencia tipo 52 por guía y registra qué guía quedó cubierta por qué factura.

1. Ver qué guías están pendientes

http
GET https://api.folyo.cl/v1/dte/guias?facturada=false
X-API-Key: tu_api_key

Cada guía trae ind_traslado (solo se facturan 1 venta, 2 ventas por efectuar y 3 consignación), facturable y facturada_por (la factura vigente que la cubre, o null).

2. Revisar el borrador (opcional)

http
POST https://api.folyo.cl/v1/dte/guias/facturar/borrador
X-API-Key: tu_api_key
Content-Type: application/json

{ "guias": [391, 392], "fecha_emision": "2026-08-31" }

Devuelve el request de emisión completo y las advertencias. Puedes editarlo y emitirlo con POST /v1/dte/emitir, o seguir al paso 3.

3. Facturar

http
POST https://api.folyo.cl/v1/dte/guias/facturar
X-API-Key: tu_api_key
Idempotency-Key: 2f1c9a0e-...
Content-Type: application/json

{ "guias": [391, 392], "detalle": "lineas" }

Responde 202 con job_id y folio, igual que la emisión normal. Consulta el resultado con GET /v1/dte/emision/{job_id} o recíbelo por webhook.

Reglas que aplica Folyo

  • Todas las guías deben ser del mismo receptor, del ambiente actual de la empresa y estar vigentes ante el SII.
  • Las guías de otro ambiente al actual de la empresa no se consideran facturables: no aparecen en facturada=false y facturarlas responde 409 GUIA_OTRO_AMBIENTE.
  • Una guía cubierta por una factura vigente (o por una emisión en curso) responde 409 GUIA_YA_FACTURADA. Si el SII rechaza esa factura, la guía vuelve a pendiente.
  • detalle: "resumen" genera una línea con el neto total de las guías y sus folios en la descripción, que es lo que el SII recomienda para facturar las guías del período. Si hay montos exentos, salen en una segunda línea.
  • El tipo de factura se deriva de las líneas: 34 si todas son exentas, 33 en cualquier otro caso.
  • Una guía de otro período que la factura no se bloquea, pero llega una advertencia. Los descuentos globales de la guía no se copian.
  • En el plan Free el XML de la guía se conserva 4 horas; sin XML no se puede armar la factura (GUIA_SIN_XML): referencia la guía a mano en POST /v1/dte/emitir con tipo_doc_ref: 52.

En la plataforma

En Documentos, cada guía muestra si está pendiente de facturar, facturada (con el folio) o no es facturable. El menú de la fila ofrece Facturar guía, que abre el formulario de emisión precargado para revisar y emitir.