comprobantes

Emitir factura (01)

Asíncrono: valida, reserva secuencial y encola. Hacer polling de GET /comprobantes/{id}. infoFactura.fechaEmision es opcional (YYYY-MM-DD, calendario de Ecuador): omitida = hoy; explícita = solo la fecha de hoy en Ecuador (cualquier otra, pasada o futura, responde 400). Cuerpo completo por tipo: ver /desarrolladores.

post/comprobantes/factura

Request

  • Base URL: https://contadeo.com/api
  • URL: https://contadeo.com/api/comprobantes/factura
  • Auth: HTTP bearer

Headers

Idempotency-Keystring

Clave de idempotencia (use un UUID por emisión): un reintento con la misma clave devuelve el comprobante original (reutilizado: true) en vez de crear otro — no quema secuencial ni duplica la factura. El alcance es por (emisor, tipo de comprobante): la misma clave usada para otro RUC o tipo del mismo tenant no colisiona. Vale en un solo ambiente: usada en Pruebas y repetida con la cuenta en Producción (o al revés) responde 422.

Request body

emisorIdstring uuid required
certificadoIdstring uuid required
establecimientostring required
puntoEmisionstring required

Response

Encolado para firma y transmisión al SRI

comprobanteIdstring uuid
claveAccesostring
estado'BORRADOR' | 'FIRMADO' | 'ENVIADO' | 'AUTORIZADO' | 'DEVUELTA' | 'RECHAZADO' | 'CONTINGENCIA' | 'ANULADO'
reutilizadoboolean

true si la Idempotency-Key ya tenía comprobante: se devuelve ese (con su estado real), sin re-emitir

advertenciasstring[]

Avisos no bloqueantes (p. ej. fecha de emisión con riesgo de error 65)

Changes

No recorded changes to this operation across all 2 revisions of this API.