Factura

POST /v1/facturas — responde 202 al instante; el veredicto del SRI llega en segundos y se consulta en comprobantes o llega por webhook.

La factura mínima que autoriza

{
  "emisor": {
    "ruc": "0999999999001",
    "razonSocial": "MI EMPRESA S.A.",
    "dirMatriz": "Av. Amazonas y Colon"
  },
  "establecimiento": "001",
  "puntoEmision": "001",
  "comprador": {
    "tipoIdentificacion": "05",
    "identificacion": "0928548817",
    "razonSocial": "JUAN PEREZ",
    "direccion": "Guayaquil"
  },
  "detalles": [
    {
      "codigoPrincipal": "SRV-1",
      "descripcion": "Servicio de consultoria",
      "cantidad": "2",
      "precioUnitario": "50.00",
      "codigoPorcentajeIva": "4"
    }
  ],
  "pagos": [{ "formaPago": "20", "total": "115.00" }]
}

2 × 50.00 + IVA 15 % = 115.00. Los subtotales y el IVA los calcula facto; el total de pagos debe cubrir el total del comprobante.

Con descuento, crédito y correo

{
  "emisor": {
    "ruc": "0999999999001",
    "razonSocial": "MI EMPRESA S.A.",
    "dirMatriz": "Av. Amazonas y Colon",
    "nombreComercial": "Mi Negocio",
    "dirEstablecimiento": "Av. 9 de Octubre 100",
    "obligadoContabilidad": "SI"
  },
  "establecimiento": "001",
  "puntoEmision": "001",
  "comprador": {
    "tipoIdentificacion": "05",
    "identificacion": "0928548817",
    "razonSocial": "JUAN PEREZ",
    "direccion": "Guayaquil"
  },
  "detalles": [
    {
      "codigoPrincipal": "LIC-001",
      "descripcion": "Licencia anual",
      "cantidad": "1",
      "precioUnitario": "120.00",
      "descuento": "20.00",
      "codigoPorcentajeIva": "4"
    }
  ],
  "pagos": [
    { "formaPago": "01", "total": "115.00", "plazo": "30", "unidadTiempo": "dias" }
  ],
  "camposAdicionales": { "Email": "cliente@ejemplo.ec" }
}

• descuento va por línea, en valor absoluto.
• El pago a crédito lleva plazo y unidadTiempo.
• camposAdicionales sale impreso en el RIDE, y si trae un correo, dispara la entrega al comprador.

Consumidor final

Para ventas sin identificar al comprador: tipoIdentificacion: "07" con identificación 9999999999999. Hasta 50 USD — sobre ese monto el SRI exige identificar al comprador y facto lo rechaza antes (FACTO-1070), con mejor mensaje que el rechazo del SRI.

Detalles que evitan sustos

• La numeración la lleva facto. El secuencial sale del punto de emisión declarado; nunca lo mandas tú.
• Una factura autorizada no se edita ni se borra. La corrección es la nota de crédito, que admite devoluciones parciales.
• Máximo 15 campos adicionales (FACTO-1071) — límite de la Ficha Técnica.