[{"data":1,"prerenderedAt":601},["ShallowReactive",2],{"navigation-ec":3,"navigation-mx":240,"/extraccion-docs":328,"/extraccion-surround":598},[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},"México","/mx","mx",[246,249,301],{"title":247,"path":243,"stem":248},"Documentación México","mx/index",{"title":5,"icon":6,"path":250,"stem":251,"children":252},"/mx/extraccion","mx/1.extraccion/index",[253,254,263,287],{"title":11,"path":250,"stem":251},{"title":14,"icon":39,"path":255,"stem":256,"children":257},"/mx/extraccion/getting-started","mx/1.extraccion/1.getting-started/index",[258,260],{"title":259,"path":255,"stem":256},"Introducción al API México",{"title":22,"path":261,"stem":262},"/mx/extraccion/getting-started/installation","mx/1.extraccion/1.getting-started/2.installation",{"title":26,"path":264,"stem":265,"children":266,"page":39},"/mx/extraccion/taxpayers","mx/1.extraccion/2.taxpayers",[267,271,275,279,283],{"title":268,"path":269,"stem":270},"Crear por CIEC","/mx/extraccion/taxpayers/create-ciec","mx/1.extraccion/2.taxpayers/1.create-ciec",{"title":272,"path":273,"stem":274},"1. Subir Certificados FIEL","/mx/extraccion/taxpayers/upload-certificados-fiel","mx/1.extraccion/2.taxpayers/2.upload-certificados-fiel",{"title":276,"path":277,"stem":278},"2. Registrar por FIEL","/mx/extraccion/taxpayers/create-fiel","mx/1.extraccion/2.taxpayers/3.create-fiel",{"title":280,"path":281,"stem":282},"Asociación CIEC / FIEL","/mx/extraccion/taxpayers/asociar","mx/1.extraccion/2.taxpayers/4.asociar",{"title":284,"path":285,"stem":286},"Consultar Taxpayers","/mx/extraccion/taxpayers/consultar","mx/1.extraccion/2.taxpayers/5.consultar",{"title":288,"path":289,"stem":290,"children":291},"Extracciones CFDI","/mx/extraccion/extractions-cfdi","mx/1.extraccion/3.extractions-cfdi/index",[292,293,297],{"title":288,"path":289,"stem":290},{"title":294,"path":295,"stem":296},"Extracción CFDI por CIEC","/mx/extraccion/extractions-cfdi/ciec","mx/1.extraccion/3.extractions-cfdi/1.ciec",{"title":298,"path":299,"stem":300},"Extracción CFDI por FIEL","/mx/extraccion/extractions-cfdi/fiel","mx/1.extraccion/3.extractions-cfdi/2.fiel",{"title":154,"icon":155,"path":302,"stem":303,"children":304},"/mx/facturacion","mx/2.facturacion/index",[305,306,309,313,317,321,325],{"title":11,"path":302,"stem":303},{"title":167,"path":307,"stem":308},"/mx/facturacion/autenticacion","mx/2.facturacion/1.autenticacion",{"title":310,"path":311,"stem":312},"Planes","/mx/facturacion/planes","mx/2.facturacion/2.planes",{"title":314,"path":315,"stem":316},"Clientes","/mx/facturacion/clientes","mx/2.facturacion/3.clientes",{"title":318,"path":319,"stem":320},"Suscripciones","/mx/facturacion/suscripciones","mx/2.facturacion/4.suscripciones",{"title":322,"path":323,"stem":324},"Folios","/mx/facturacion/folios","mx/2.facturacion/5.folios",{"title":150,"path":326,"stem":327},"/mx/facturacion/referencia","mx/2.facturacion/9.referencia",{"id":329,"title":5,"body":330,"datil":591,"description":592,"extension":593,"links":591,"meta":594,"navigation":595,"path":7,"seo":596,"stem":12,"__hash__":597},"docs/1.extraccion/index.md",{"type":331,"value":332,"toc":585},"minimark",[333,337,340,345,393,397,400,448,451,456,459,466,503,510,514,573,581],[334,335,336],"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.",[334,338,339],{},"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.",[341,342,344],"h2",{"id":343},"cómo-empezar","Cómo empezar",[346,347,348,364,375,384],"ol",{},[349,350,351,355,356,363],"li",{},[352,353,354],"strong",{},"Solicita tu cuenta."," Pide acceso en el ",[357,358,362],"a",{"href":359,"rel":360},"https://tally.so/r/mVZaKE",[361],"nofollow","formulario de credenciales",";\nel equipo de Taxo te entrega una clave de API.",[349,365,366,369,370,374],{},[352,367,368],{},"Integra contra staging."," Apunta a ",[371,372,373],"code",{},"https://staging-api.taxo.ws"," mientras desarrollas.",[349,376,377,380,381,383],{},[352,378,379],{},"Registra un contribuyente."," Es el primer recurso que necesita cualquier extracción:\nver ",[357,382,26],{"href":33},".",[349,385,386,389,390,383],{},[352,387,388],{},"Lanza tu primera extracción"," y recibe el resultado por ",[357,391,392],{"href":104},"webhook",[341,394,396],{"id":395},"ambientes","Ambientes",[334,398,399],{},"Cada ambiente tiene su propia clave de API. Una clave de staging no funciona en\nproducción.",[401,402,403,419],"table",{},[404,405,406],"thead",{},[407,408,409,413,416],"tr",{},[410,411,412],"th",{},"Ambiente",[410,414,415],{},"URL base",[410,417,418],{},"Uso",[420,421,422,435],"tbody",{},[407,423,424,428,432],{},[425,426,427],"td",{},"Pruebas",[425,429,430],{},[371,431,373],{},[425,433,434],{},"Integración y desarrollo. Los datos no son definitivos.",[407,436,437,440,445],{},[425,438,439],{},"Producción",[425,441,442],{},[371,443,444],{},"https://api.taxo.ws",[425,446,447],{},"Datos reales del SRI.",[334,449,450],{},"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:",[452,453],"api-endpoint",{"host":373,"method":454,"path":455},"POST","/taxpayers",[341,457,167],{"id":458},"autenticación",[334,460,461,462,465],{},"Todas las rutas del API exigen la cabecera ",[371,463,464],{},"x-api-key",". No hay sesiones ni\ntokens que expiren: cada llamada viaja con su credencial.",[467,468,474],"pre",{"className":469,"code":470,"filename":471,"language":472,"meta":473,"style":473},"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","",[371,475,476,493],{"__ignoreMap":473},[477,478,481,485,489],"span",{"class":479,"line":480},"line",1,[477,482,484],{"class":483},"s7cIb","curl",[477,486,488],{"class":487},"s2YLD"," https://staging-api.taxo.ws/taxpayers",[477,490,492],{"class":491},"szD4K"," \\\n",[477,494,496,500],{"class":479,"line":495},2,[477,497,499],{"class":498},"sr2uH","  -H",[477,501,502],{"class":487}," \"x-api-key: staging_evBmjgmR_XXXXXXXXXXXXXXX\"\n",[334,504,505,506,509],{},"La clave de staging se distingue por su prefijo ",[371,507,508],{},"staging_",". Trátala como un\nsecreto: guárdala en tu gestor de configuración y nunca la publiques en el\ncliente.",[341,511,513],{"id":512},"qué-incluye-esta-sección","Qué incluye esta sección",[401,515,516,526],{},[404,517,518],{},[407,519,520,523],{},[410,521,522],{},"Sección",[410,524,525],{},"Para qué sirve",[420,527,528,537,546,555,564],{},[407,529,530,534],{},[425,531,532],{},[357,533,14],{"href":16},[425,535,536],{},"Características del API y pasos de alta de la cuenta.",[407,538,539,543],{},[425,540,541],{},[357,542,26],{"href":33},[425,544,545],{},"Registra y actualiza los RUC sobre los que vas a operar.",[407,547,548,552],{},[425,549,550],{},[357,551,41],{"href":43},[425,553,554],{},"Compras, ventas y RIDE en XML, PDF y JSON.",[407,556,557,561],{},[425,558,559],{},[357,560,103],{"href":104},[425,562,563],{},"Recibe el resultado de cada proceso asíncrono.",[407,565,566,570],{},[425,567,568],{},[357,569,110],{"href":112},[425,571,572],{},"Régimen fiscal, obligaciones, RUC público, buzón tributario y más.",[574,575,576],"note",{},[334,577,578,579,383],{},"¿Necesitas emitir comprobantes electrónicos en vez de extraerlos? Esa es la otra\nmitad del portal: ",[357,580,154],{"href":156},[582,583,584],"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":473,"searchDepth":480,"depth":495,"links":586},[587,588,589,590],{"id":343,"depth":495,"text":344},{"id":395,"depth":495,"text":396},{"id":458,"depth":495,"text":167},{"id":512,"depth":495,"text":513},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":592},"6hkHUFHrEjvSv9yVlOmgl63DWfRWtxx-XlkMBaIhiiU",[591,599],{"title":20,"path":16,"stem":17,"description":600,"children":-1},"Documentación oficial del API de TAXO WS, diseñado para integrarse con el SRI de Ecuador.",1792432116888]