[{"data":1,"prerenderedAt":569},["ShallowReactive",2],{"navigation-ec":3,"navigation-mx":240,"/extraccion-docs":296,"/extraccion-surround":566},[4,153],{"title":5,"icon":6,"path":7,"stem":8,"children":9},"Extracción","i-lucide-download","/extraccion","1.extraccion",[10,13,25,40,102,109,149],{"title":11,"path":7,"stem":12},"Introducción","1.extraccion/index",{"title":14,"icon":15,"path":16,"stem":17,"children":18},"Empecemos","i-lucide-rocket","/extraccion/getting-started","1.extraccion/1.getting-started/index",[19,21],{"title":20,"path":16,"stem":17},"Introducción al API",{"title":22,"path":23,"stem":24},"Primeros Pasos","/extraccion/getting-started/installation","1.extraccion/1.getting-started/2.installation",{"title":26,"icon":27,"path":28,"stem":29,"children":30,"page":39},"Contribuyentes","i-lucide-users","/extraccion/taxpayers","1.extraccion/2.taxpayers",[31,35],{"title":32,"path":33,"stem":34},"Crear","/extraccion/taxpayers/create","1.extraccion/2.taxpayers/1.create",{"title":36,"path":37,"stem":38},"Actualizar","/extraccion/taxpayers/update","1.extraccion/2.taxpayers/2.update",false,{"title":41,"icon":42,"path":43,"stem":44,"children":45},"Extraer documentos","i-lucide-file-stack","/extraccion/extractions","1.extraccion/3.extractions/index",[46,48,52,81],{"title":47,"path":43,"stem":44},"Extracciones",{"title":49,"path":50,"stem":51},"RIDE","/extraccion/extractions/ride","1.extraccion/3.extractions/2.Ride",{"title":53,"path":54,"stem":55,"children":56,"page":39},"Documentos Recibidos","/extraccion/extractions/compras","1.extraccion/3.extractions/compras",[57,61,65,69,73,77],{"title":58,"path":59,"stem":60},"Compras","/extraccion/extractions/compras/purchases","1.extraccion/3.extractions/compras/1.purchases",{"title":62,"path":63,"stem":64},"Retenciones","/extraccion/extractions/compras/retentions","1.extraccion/3.extractions/compras/2.retentions",{"title":66,"path":67,"stem":68},"Notas de crédito","/extraccion/extractions/compras/credit-notes","1.extraccion/3.extractions/compras/3.credit-notes",{"title":70,"path":71,"stem":72},"Notas de débito","/extraccion/extractions/compras/debit-notes","1.extraccion/3.extractions/compras/4.debit-notes",{"title":74,"path":75,"stem":76},"Liquidaciones","/extraccion/extractions/compras/settlements","1.extraccion/3.extractions/compras/5.settlements",{"title":78,"path":79,"stem":80},"Anulados","/extraccion/extractions/compras/purchase-voids","1.extraccion/3.extractions/compras/6.purchase-voids",{"title":82,"path":83,"stem":84,"children":85,"page":39},"Documentos Emitidos","/extraccion/extractions/ventas","1.extraccion/3.extractions/ventas",[86,90,93,96,99],{"title":87,"path":88,"stem":89},"Ventas","/extraccion/extractions/ventas/invoices","1.extraccion/3.extractions/ventas/1.invoices",{"title":62,"path":91,"stem":92},"/extraccion/extractions/ventas/retentions","1.extraccion/3.extractions/ventas/2.retentions",{"title":66,"path":94,"stem":95},"/extraccion/extractions/ventas/credit-notes","1.extraccion/3.extractions/ventas/3.credit-notes",{"title":74,"path":97,"stem":98},"/extraccion/extractions/ventas/settlements","1.extraccion/3.extractions/ventas/4.settlements",{"title":78,"path":100,"stem":101},"/extraccion/extractions/ventas/sales-voids","1.extraccion/3.extractions/ventas/5.sales-voids",{"title":103,"path":104,"stem":105,"children":106,"icon":108},"Webhooks","/extraccion/webhooks","1.extraccion/4.webhooks/index",[107],{"title":103,"path":104,"stem":105},"i-lucide-webhook",{"title":110,"icon":111,"path":112,"stem":113,"children":114},"Consultas","i-lucide-search","/extraccion/consultas","1.extraccion/5.consultas/index",[115,117,121,125,129,133,137,141,145],{"title":116,"path":112,"stem":113},"Consultas y Solicitudes",{"title":118,"path":119,"stem":120},"Régimen Fiscal","/extraccion/consultas/regimen-fiscal","1.extraccion/5.consultas/1.regimen-fiscal",{"title":122,"path":123,"stem":124},"Obligaciones Fiscales","/extraccion/consultas/obligaciones-fiscales","1.extraccion/5.consultas/2.obligaciones-fiscales",{"title":126,"path":127,"stem":128},"Registro Público del Contribuyente (RUC)","/extraccion/consultas/registro-publico-ruc","1.extraccion/5.consultas/3.registro-publico-ruc",{"title":130,"path":131,"stem":132},"Solicitud de Extracción y Descarga de Documentos (RIDE/XML)","/extraccion/consultas/solicitud-extraccion-documentos","1.extraccion/5.consultas/4.solicitud-extraccion-documentos",{"title":134,"path":135,"stem":136},"Consulta y Búsqueda de Contribuyentes de la Organización","/extraccion/consultas/consulta-busqueda-contribuyentes","1.extraccion/5.consultas/5.consulta-busqueda-contribuyentes",{"title":138,"path":139,"stem":140},"Solicitud de Categorización de Documento con IA","/extraccion/consultas/solicitud-categorizacion-ia","1.extraccion/5.consultas/6.solicitud-categorizacion-ia",{"title":142,"path":143,"stem":144},"Solicitud de Descarga de Declaraciones (PDF) del SRI","/extraccion/consultas/solicitud-descarga-declaraciones","1.extraccion/5.consultas/7.solicitud-descarga-declaraciones",{"title":146,"path":147,"stem":148},"Buzón Tributario (Inbox) del Contribuyente","/extraccion/consultas/buzon-tributario-inbox","1.extraccion/5.consultas/8.buzon-tributario-inbox",{"title":150,"path":151,"stem":152},"Referencia de la API","/extraccion/referencia","1.extraccion/9.referencia",{"title":154,"icon":155,"path":156,"stem":157,"children":158},"Facturación","i-lucide-receipt","/facturacion","2.facturacion",[159,161,170,196,218],{"title":11,"path":156,"stem":160},"2.facturacion/index",{"title":162,"icon":15,"path":163,"stem":164,"children":165,"page":39},"Empezar","/facturacion/empezar","2.facturacion/1.empezar",[166],{"title":167,"path":168,"stem":169},"Autenticación","/facturacion/empezar/autenticacion","2.facturacion/1.empezar/1.autenticacion",{"title":171,"icon":172,"path":173,"stem":174,"children":175,"page":39},"Comprobantes","i-lucide-file-text","/facturacion/comprobantes","2.facturacion/2.comprobantes",[176,180,183,186,189,193],{"title":177,"path":178,"stem":179},"Facturas","/facturacion/comprobantes/facturas","2.facturacion/2.comprobantes/1.facturas",{"title":66,"path":181,"stem":182},"/facturacion/comprobantes/notas-de-credito","2.facturacion/2.comprobantes/2.notas-de-credito",{"title":70,"path":184,"stem":185},"/facturacion/comprobantes/notas-de-debito","2.facturacion/2.comprobantes/3.notas-de-debito",{"title":62,"path":187,"stem":188},"/facturacion/comprobantes/retenciones","2.facturacion/2.comprobantes/4.retenciones",{"title":190,"path":191,"stem":192},"Guías de remisión","/facturacion/comprobantes/guias-de-remision","2.facturacion/2.comprobantes/5.guias-de-remision",{"title":74,"path":194,"stem":195},"/facturacion/comprobantes/liquidaciones-de-compra","2.facturacion/2.comprobantes/6.liquidaciones-de-compra",{"title":197,"icon":198,"path":199,"stem":200,"children":201,"page":39},"Operaciones","i-lucide-workflow","/facturacion/operaciones","2.facturacion/3.operaciones",[202,206,210,214],{"title":203,"path":204,"stem":205},"Autorización","/facturacion/operaciones/autorizacion-de-comprobantes","2.facturacion/3.operaciones/1.autorizacion-de-comprobantes",{"title":207,"path":208,"stem":209},"Descarga","/facturacion/operaciones/descarga-de-comprobantes","2.facturacion/3.operaciones/2.descarga-de-comprobantes",{"title":211,"path":212,"stem":213},"Envío por correo","/facturacion/operaciones/envio-por-correo","2.facturacion/3.operaciones/3.envio-por-correo",{"title":215,"path":216,"stem":217},"Notificaciones","/facturacion/operaciones/notificaciones","2.facturacion/3.operaciones/4.notificaciones",{"title":219,"icon":220,"path":221,"stem":222,"children":223,"page":39},"Referencia","i-lucide-book-open","/facturacion/referencia","2.facturacion/4.referencia",[224,228,232,236],{"title":225,"path":226,"stem":227},"Objetos comunes","/facturacion/referencia/objetos-comunes","2.facturacion/4.referencia/1.objetos-comunes",{"title":229,"path":230,"stem":231},"Catálogo","/facturacion/referencia/catalogo","2.facturacion/4.referencia/2.catalogo",{"title":233,"path":234,"stem":235},"Consulta de catálogo","/facturacion/referencia/consulta-de-catalogo","2.facturacion/4.referencia/3.consulta-de-catalogo",{"title":237,"path":238,"stem":239},"Errores","/facturacion/referencia/errores","2.facturacion/4.referencia/4.errores",[241],{"title":242,"path":243,"stem":244,"children":245},"Mx","/mx","mx",[246,249,258,282],{"title":247,"path":243,"stem":248},"Documentación México","mx/index",{"title":14,"icon":39,"path":250,"stem":251,"children":252},"/mx/getting-started","mx/1.getting-started/index",[253,255],{"title":254,"path":250,"stem":251},"Introducción al API México",{"title":22,"path":256,"stem":257},"/mx/getting-started/installation","mx/1.getting-started/2.installation",{"title":26,"path":259,"stem":260,"children":261,"page":39},"/mx/taxpayers","mx/2.taxpayers",[262,266,270,274,278],{"title":263,"path":264,"stem":265},"Crear por CIEC","/mx/taxpayers/create-ciec","mx/2.taxpayers/1.create-ciec",{"title":267,"path":268,"stem":269},"1. Subir Certificados FIEL","/mx/taxpayers/upload-certificados-fiel","mx/2.taxpayers/2.upload-certificados-fiel",{"title":271,"path":272,"stem":273},"2. Registrar por FIEL","/mx/taxpayers/create-fiel","mx/2.taxpayers/3.create-fiel",{"title":275,"path":276,"stem":277},"Asociación CIEC / FIEL","/mx/taxpayers/asociar","mx/2.taxpayers/4.asociar",{"title":279,"path":280,"stem":281},"Consultar Taxpayers","/mx/taxpayers/consultar","mx/2.taxpayers/5.consultar",{"title":283,"path":284,"stem":285,"children":286},"Extracciones CFDI","/mx/extractions-cfdi","mx/3.extractions-cfdi/index",[287,288,292],{"title":283,"path":284,"stem":285},{"title":289,"path":290,"stem":291},"Extracción CFDI por CIEC","/mx/extractions-cfdi/ciec","mx/3.extractions-cfdi/1.ciec",{"title":293,"path":294,"stem":295},"Extracción CFDI por FIEL","/mx/extractions-cfdi/fiel","mx/3.extractions-cfdi/2.fiel",{"id":297,"title":5,"body":298,"datil":559,"description":560,"extension":561,"links":559,"meta":562,"navigation":563,"path":7,"seo":564,"stem":12,"__hash__":565},"docs/1.extraccion/index.md",{"type":299,"value":300,"toc":553},"minimark",[301,305,308,313,361,365,368,416,419,424,427,434,471,478,482,541,549],[302,303,304],"p",{},"El API de Extracción conecta tu aplicación con el Servicio de Rentas Internas\n(SRI) de Ecuador y con el SAT de México. Con una sola credencial puedes\nregistrar contribuyentes, extraer sus documentos fiscales en XML, PDF y JSON,\nconsultar su información tributaria y recibir cada resultado por webhook.",[302,306,307],{},"El SRI no ofrece un API pública. Taxo se encarga de esa integración y te entrega\ndatos estructurados, actualizados y listos para procesar.",[309,310,312],"h2",{"id":311},"cómo-empezar","Cómo empezar",[314,315,316,332,343,352],"ol",{},[317,318,319,323,324,331],"li",{},[320,321,322],"strong",{},"Solicita tu cuenta."," Pide acceso en el ",[325,326,330],"a",{"href":327,"rel":328},"https://tally.so/r/mVZaKE",[329],"nofollow","formulario de credenciales",";\nel equipo de Taxo te entrega una clave de API.",[317,333,334,337,338,342],{},[320,335,336],{},"Integra contra staging."," Apunta a ",[339,340,341],"code",{},"https://staging-api.taxo.ws"," mientras desarrollas.",[317,344,345,348,349,351],{},[320,346,347],{},"Registra un contribuyente."," Es el primer recurso que necesita cualquier extracción:\nver ",[325,350,26],{"href":33},".",[317,353,354,357,358,351],{},[320,355,356],{},"Lanza tu primera extracción"," y recibe el resultado por ",[325,359,360],{"href":104},"webhook",[309,362,364],{"id":363},"ambientes","Ambientes",[302,366,367],{},"Cada ambiente tiene su propia clave de API. Una clave de staging no funciona en\nproducción.",[369,370,371,387],"table",{},[372,373,374],"thead",{},[375,376,377,381,384],"tr",{},[378,379,380],"th",{},"Ambiente",[378,382,383],{},"URL base",[378,385,386],{},"Uso",[388,389,390,403],"tbody",{},[375,391,392,396,400],{},[393,394,395],"td",{},"Pruebas",[393,397,398],{},[339,399,341],{},[393,401,402],{},"Integración y desarrollo. Los datos no son definitivos.",[375,404,405,408,413],{},[393,406,407],{},"Producción",[393,409,410],{},[339,411,412],{},"https://api.taxo.ws",[393,414,415],{},"Datos reales del SRI.",[302,417,418],{},"Una operación se arma combinando el verbo HTTP, la URL base y la ruta descrita\nen cada página. Por ejemplo, para registrar un contribuyente:",[420,421],"api-endpoint",{"host":341,"method":422,"path":423},"POST","/taxpayers",[309,425,167],{"id":426},"autenticación",[302,428,429,430,433],{},"Todas las rutas del API exigen la cabecera ",[339,431,432],{},"x-api-key",". No hay sesiones ni\ntokens que expiren: cada llamada viaja con su credencial.",[435,436,442],"pre",{"className":437,"code":438,"filename":439,"language":440,"meta":441,"style":441},"language-bash shiki shiki-themes github-light github-light github-dark-default","curl https://staging-api.taxo.ws/taxpayers \\\n  -H \"x-api-key: staging_evBmjgmR_XXXXXXXXXXXXXXX\"\n","Terminal","bash","",[339,443,444,461],{"__ignoreMap":441},[445,446,449,453,457],"span",{"class":447,"line":448},"line",1,[445,450,452],{"class":451},"s7cIb","curl",[445,454,456],{"class":455},"s2YLD"," https://staging-api.taxo.ws/taxpayers",[445,458,460],{"class":459},"szD4K"," \\\n",[445,462,464,468],{"class":447,"line":463},2,[445,465,467],{"class":466},"sr2uH","  -H",[445,469,470],{"class":455}," \"x-api-key: staging_evBmjgmR_XXXXXXXXXXXXXXX\"\n",[302,472,473,474,477],{},"La clave de staging se distingue por su prefijo ",[339,475,476],{},"staging_",". Trátala como un\nsecreto: guárdala en tu gestor de configuración y nunca la publiques en el\ncliente.",[309,479,481],{"id":480},"qué-incluye-esta-sección","Qué incluye esta sección",[369,483,484,494],{},[372,485,486],{},[375,487,488,491],{},[378,489,490],{},"Sección",[378,492,493],{},"Para qué sirve",[388,495,496,505,514,523,532],{},[375,497,498,502],{},[393,499,500],{},[325,501,14],{"href":16},[393,503,504],{},"Características del API y pasos de alta de la cuenta.",[375,506,507,511],{},[393,508,509],{},[325,510,26],{"href":33},[393,512,513],{},"Registra y actualiza los RUC sobre los que vas a operar.",[375,515,516,520],{},[393,517,518],{},[325,519,41],{"href":43},[393,521,522],{},"Compras, ventas y RIDE en XML, PDF y JSON.",[375,524,525,529],{},[393,526,527],{},[325,528,103],{"href":104},[393,530,531],{},"Recibe el resultado de cada proceso asíncrono.",[375,533,534,538],{},[393,535,536],{},[325,537,110],{"href":112},[393,539,540],{},"Régimen fiscal, obligaciones, RUC público, buzón tributario y más.",[542,543,544],"note",{},[302,545,546,547,351],{},"¿Necesitas emitir comprobantes electrónicos en vez de extraerlos? Esa es la otra\nmitad del portal: ",[325,548,154],{"href":156},[550,551,552],"style",{},"html pre.shiki code .s7cIb, html code.shiki .s7cIb{--shiki-light:#6F42C1;--shiki-default:#6F42C1;--shiki-dark:#FFA657}html pre.shiki code .s2YLD, html code.shiki .s2YLD{--shiki-light:#032F62;--shiki-default:#032F62;--shiki-dark:#A5D6FF}html pre.shiki code .szD4K, html code.shiki .szD4K{--shiki-light:#005CC5;--shiki-default:#005CC5;--shiki-dark:#FF7B72}html pre.shiki code .sr2uH, html code.shiki .sr2uH{--shiki-light:#005CC5;--shiki-default:#005CC5;--shiki-dark:#79C0FF}html .light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html.light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html .default .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html.dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}",{"title":441,"searchDepth":448,"depth":463,"links":554},[555,556,557,558],{"id":311,"depth":463,"text":312},{"id":363,"depth":463,"text":364},{"id":426,"depth":463,"text":167},{"id":480,"depth":463,"text":481},null,"El API propio de Taxo para extraer documentos fiscales del SRI, consultar contribuyentes y recibir notificaciones por webhook.","md",{},{"title":11},{"title":5,"description":560},"6hkHUFHrEjvSv9yVlOmgl63DWfRWtxx-XlkMBaIhiiU",[559,567],{"title":20,"path":16,"stem":17,"description":568,"children":-1},"Documentación oficial del API de TAXO WS, diseñado para integrarse con el SRI de Ecuador.",1790201862774]