{"openapi":"3.0.3","info":{"title":"API de Facturaci\u00f3n Electr\u00f3nica","version":"1.0","description":"Emisi\u00f3n de comprobantes por JSON (X-Key, recomendado para integraciones nuevas), subida de XML para clientes legacy, y consulta de compras (Bearer)."},"servers":[{"url":"https:\/\/facturacion.disisot.com"}],"security":[{"XKey":[]}],"components":{"securitySchemes":{"XKey":{"type":"apiKey","in":"header","name":"X-Key"},"bearerAuth":{"type":"http","scheme":"bearer"}}},"paths":{"\/facturacion\/api\/v1\/invoices\/issue":{"post":{"summary":"Emitir factura (JSON \u2014 recomendado)","tags":["Emisi\u00f3n"],"requestBody":{"required":true,"content":{"application\/json":{"example":{"ambiente":"1","tipo_emision":"1","custom_uid":"abc-123","secuencial":"123","fecha_emision":"2026-06-20 10:00:00","emisor":{"ruc":"1790012345001","razon_social":"MI EMPRESA S.A.","establecimiento":{"codigo":"001","punto_emision":"001"},"obligado_contabilidad":true},"comprador":{"tipo_identificacion":"05","identificacion":"1710034065001","razon_social":"JUAN PEREZ","direccion":"Av. Siempre Viva 123","email":"cliente@correo.com"},"detalles":[{"codigo_principal":"P001","descripcion":"SERVICIO PROFESIONAL","cantidad":1,"precio_unitario":100,"descuento":0,"impuestos":[{"codigo":"2","codigo_porcentaje":"4","tarifa":15,"base_imponible":100,"valor":15}]}],"pagos":[{"forma_pago":"01","total":115}]}}}},"responses":{"201":{"description":"Comprobante recibido"}}}},"\/facturacion\/api\/v1\/invoices\/issue-xml":{"post":{"summary":"Emitir subiendo un XML ya armado (solo clientes legacy)","description":"Para clientes legacy que ya generan el XML del comprobante. Los sistemas NUEVOS deben usar la emisi\u00f3n por JSON (\/invoices\/issue). Env\u00eda el XML como archivo en el campo \"xml\" (multipart) o como cuerpo application\/xml. El servicio lo firma, lo env\u00eda al SRI y lo autoriza.","tags":["Emisi\u00f3n (legacy XML)"],"requestBody":{"required":true,"content":{"multipart\/form-data":{"schema":{"type":"object","properties":{"xml":{"type":"string","format":"binary"}}}},"application\/xml":{"schema":{"type":"string"}}}},"responses":{"201":{"description":"XML recibido y enviado a procesar (claveAcceso, estado)"}}}},"\/facturacion\/api\/v1\/credit-notes\/issue":{"post":{"summary":"Emitir nota de cr\u00e9dito","tags":["Emisi\u00f3n"],"requestBody":{"required":true,"content":{"application\/json":{"example":{"ambiente":"1","tipo_emision":"1","custom_uid":"abc-123","secuencial":"123","fecha_emision":"2026-06-20 10:00:00","emisor":{"ruc":"1790012345001","razon_social":"MI EMPRESA S.A.","establecimiento":{"codigo":"001","punto_emision":"001"},"obligado_contabilidad":true},"comprador":{"tipo_identificacion":"05","identificacion":"1710034065001","razon_social":"JUAN PEREZ","direccion":"Av. Siempre Viva 123","email":"cliente@correo.com"},"detalles":[{"codigo_principal":"P001","descripcion":"SERVICIO PROFESIONAL","cantidad":1,"precio_unitario":100,"descuento":0,"impuestos":[{"codigo":"2","codigo_porcentaje":"4","tarifa":15,"base_imponible":100,"valor":15}]}],"pagos":[{"forma_pago":"01","total":115}]}}}},"responses":{"201":{"description":"Comprobante recibido"}}}},"\/facturacion\/api\/v1\/debit-notes\/issue":{"post":{"summary":"Emitir nota de d\u00e9bito","tags":["Emisi\u00f3n"],"requestBody":{"required":true,"content":{"application\/json":{"example":{"ambiente":"1","tipo_emision":"1","custom_uid":"abc-123","secuencial":"123","fecha_emision":"2026-06-20 10:00:00","emisor":{"ruc":"1790012345001","razon_social":"MI EMPRESA S.A.","establecimiento":{"codigo":"001","punto_emision":"001"},"obligado_contabilidad":true},"comprador":{"tipo_identificacion":"05","identificacion":"1710034065001","razon_social":"JUAN PEREZ","direccion":"Av. Siempre Viva 123","email":"cliente@correo.com"},"detalles":[{"codigo_principal":"P001","descripcion":"SERVICIO PROFESIONAL","cantidad":1,"precio_unitario":100,"descuento":0,"impuestos":[{"codigo":"2","codigo_porcentaje":"4","tarifa":15,"base_imponible":100,"valor":15}]}],"pagos":[{"forma_pago":"01","total":115}]}}}},"responses":{"201":{"description":"Comprobante recibido"}}}},"\/facturacion\/api\/v1\/retentions\/issue":{"post":{"summary":"Emitir retenci\u00f3n","tags":["Emisi\u00f3n"],"requestBody":{"required":true,"content":{"application\/json":{"example":{"ambiente":"1","tipo_emision":"1","custom_uid":"abc-123","secuencial":"123","fecha_emision":"2026-06-20 10:00:00","emisor":{"ruc":"1790012345001","razon_social":"MI EMPRESA S.A.","establecimiento":{"codigo":"001","punto_emision":"001"},"obligado_contabilidad":true},"comprador":{"tipo_identificacion":"05","identificacion":"1710034065001","razon_social":"JUAN PEREZ","direccion":"Av. Siempre Viva 123","email":"cliente@correo.com"},"detalles":[{"codigo_principal":"P001","descripcion":"SERVICIO PROFESIONAL","cantidad":1,"precio_unitario":100,"descuento":0,"impuestos":[{"codigo":"2","codigo_porcentaje":"4","tarifa":15,"base_imponible":100,"valor":15}]}],"pagos":[{"forma_pago":"01","total":115}]}}}},"responses":{"201":{"description":"Comprobante recibido"}}}},"\/facturacion\/api\/v1\/waybills\/issue":{"post":{"summary":"Emitir gu\u00eda de remisi\u00f3n","tags":["Emisi\u00f3n"],"requestBody":{"required":true,"content":{"application\/json":{"example":{"ambiente":"1","tipo_emision":"1","custom_uid":"abc-123","secuencial":"123","fecha_emision":"2026-06-20 10:00:00","emisor":{"ruc":"1790012345001","razon_social":"MI EMPRESA S.A.","establecimiento":{"codigo":"001","punto_emision":"001"},"obligado_contabilidad":true},"comprador":{"tipo_identificacion":"05","identificacion":"1710034065001","razon_social":"JUAN PEREZ","direccion":"Av. Siempre Viva 123","email":"cliente@correo.com"},"detalles":[{"codigo_principal":"P001","descripcion":"SERVICIO PROFESIONAL","cantidad":1,"precio_unitario":100,"descuento":0,"impuestos":[{"codigo":"2","codigo_porcentaje":"4","tarifa":15,"base_imponible":100,"valor":15}]}],"pagos":[{"forma_pago":"01","total":115}]}}}},"responses":{"201":{"description":"Comprobante recibido"}}}},"\/facturacion\/api\/v1\/purchase-settlements\/issue":{"post":{"summary":"Emitir liquidaci\u00f3n de compra","tags":["Emisi\u00f3n"],"requestBody":{"required":true,"content":{"application\/json":{"example":{"ambiente":"1","tipo_emision":"1","custom_uid":"abc-123","secuencial":"123","fecha_emision":"2026-06-20 10:00:00","emisor":{"ruc":"1790012345001","razon_social":"MI EMPRESA S.A.","establecimiento":{"codigo":"001","punto_emision":"001"},"obligado_contabilidad":true},"comprador":{"tipo_identificacion":"05","identificacion":"1710034065001","razon_social":"JUAN PEREZ","direccion":"Av. Siempre Viva 123","email":"cliente@correo.com"},"detalles":[{"codigo_principal":"P001","descripcion":"SERVICIO PROFESIONAL","cantidad":1,"precio_unitario":100,"descuento":0,"impuestos":[{"codigo":"2","codigo_porcentaje":"4","tarifa":15,"base_imponible":100,"valor":15}]}],"pagos":[{"forma_pago":"01","total":115}]}}}},"responses":{"201":{"description":"Comprobante recibido"}}}},"\/facturacion\/api\/v1\/invoices\/{clave}":{"get":{"summary":"Consultar comprobante","tags":["Consulta"],"parameters":[{"name":"clave","in":"path","required":true,"schema":{"type":"string"},"description":"Clave de acceso (49 d\u00edgitos)"}],"responses":{"200":{"description":"Estado del comprobante"}}}},"\/facturacion\/api\/v1\/invoices\/{clave}\/reissue":{"post":{"summary":"Reprocesar (re-firmar y reenviar al SRI)","tags":["Reenv\u00edo"],"parameters":[{"name":"clave","in":"path","required":true,"schema":{"type":"string"},"description":"Clave de acceso (49 d\u00edgitos)"}],"responses":{"200":{"description":"Reenviado a procesar"}}}},"\/facturacion\/api\/v1\/edocs\/send-email\/{clave}":{"post":{"summary":"Reenviar correo al receptor","tags":["Reenv\u00edo"],"parameters":[{"name":"clave","in":"path","required":true,"schema":{"type":"string"},"description":"Clave de acceso (49 d\u00edgitos)"}],"responses":{"200":{"description":"Encolado"}}}},"\/facturacion\/api\/v1\/ver\/{clave}\/xml":{"get":{"summary":"Descargar XML","tags":["Descarga"],"parameters":[{"name":"clave","in":"path","required":true,"schema":{"type":"string"},"description":"Clave de acceso (49 d\u00edgitos)"}],"responses":{"200":{"description":"XML"}}}},"\/facturacion\/api\/v1\/ver\/{clave}\/pdf":{"get":{"summary":"Descargar RIDE (PDF)","tags":["Descarga"],"parameters":[{"name":"clave","in":"path","required":true,"schema":{"type":"string"},"description":"Clave de acceso (49 d\u00edgitos)"}],"responses":{"200":{"description":"PDF"}}}},"\/api\/v1\/compras":{"get":{"summary":"Consultar compras (comprobantes recibidos del SRI)","tags":["Compras"],"security":[{"bearerAuth":[]}],"parameters":[{"name":"periodo","in":"query","schema":{"type":"string"},"description":"YYYY-MM"},{"name":"emisor_id","in":"query","schema":{"type":"integer"}}],"responses":{"200":{"description":"Compras + totales (base, iva, total, cr\u00e9dito tributario)"}}}}}}