[{"data":1,"prerenderedAt":588},["ShallowReactive",2],{"navigation-ec":3,"navigation-mx":240,"/facturacion-docs":296,"/facturacion-surround":583},[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":154,"body":298,"datil":576,"description":577,"extension":578,"links":576,"meta":579,"navigation":580,"path":156,"seo":581,"stem":160,"__hash__":582},"docs/2.facturacion/index.md",{"type":299,"value":300,"toc":567},"minimark",[301,305,308,313,316,322,325,330,334,341,390,399,403,406,430,437,445,448,480,487,561],[302,303,304],"p",{},"Taxo Facturación emite comprobantes electrónicos autorizados por el SRI: facturas,\nnotas de crédito, notas de débito, comprobantes de retención, guías de remisión y\nliquidaciones de compra.",[302,306,307],{},"El API está diseñado como un servicio web REST. Todas las operaciones reciben y\nresponden JSON, incluso los errores.",[309,310,312],"h2",{"id":311},"url-base","URL base",[302,314,315],{},"Todas las rutas de esta sección son relativas a:",[302,317,318],{},[319,320,321],"code",{},"https://invoice.taxo.ws",[302,323,324],{},"Una operación se arma combinando el verbo HTTP, la URL base y la ruta descrita en\ncada página. Por ejemplo, para emitir una factura:",[326,327],"api-endpoint",{"method":328,"path":329},"POST","/invoices/issue",[309,331,333],{"id":332},"ambientes","Ambientes",[302,335,336,337,340],{},"Cada comprobante declara el ambiente contra el que se emite en el campo ",[319,338,339],{},"ambiente",":",[342,343,344,360],"table",{},[345,346,347],"thead",{},[348,349,350,354,357],"tr",{},[351,352,353],"th",{},"Valor",[351,355,356],{},"Ambiente",[351,358,359],{},"Uso",[361,362,363,377],"tbody",{},[348,364,365,371,374],{},[366,367,368],"td",{},[319,369,370],{},"1",[366,372,373],{},"Pruebas",[366,375,376],{},"Los comprobantes se autorizan contra el ambiente de pruebas del SRI.",[348,378,379,384,387],{},[366,380,381],{},[319,382,383],{},"2",[366,385,386],{},"Producción",[366,388,389],{},"Los comprobantes tienen validez tributaria.",[391,392,393],"warning",{},[302,394,395,396,398],{},"Un comprobante emitido en pruebas no tiene validez tributaria. Verificá el valor de\n",[319,397,339],{}," antes de salir a producción.",[309,400,402],{"id":401},"credenciales","Credenciales",[302,404,405],{},"Para consumir el API necesitás dos claves:",[407,408,409,421],"ul",{},[410,411,412,416,417,420],"li",{},[413,414,415],"strong",{},"Clave del API"," (",[319,418,419],{},"X-Key","): identifica a tu aplicación.",[410,422,423,416,426,429],{},[413,424,425],{},"Clave del certificado de firma",[319,427,428],{},"X-Password","): firma electrónicamente cada\ncomprobante antes de enviarlo al SRI.",[302,431,432,433,436],{},"Solicitá tu API key al equipo de Taxo. El detalle de las cabeceras está en\n",[434,435,167],"a",{"href":168},".",[309,438,440],{"id":439},"proceso-de-emisión",[441,442,444],"span",{"id":443},"proceso-de-emision","Proceso de emisión",[302,446,447],{},"Taxo Facturación se encarga del ciclo completo. Bajo condiciones normales toma\nentre 3 y 5 segundos; después de ese período basta con consultar el comprobante\npara conocer su estado.",[449,450,451,457,463,469,475],"ol",{},[410,452,453,456],{},[413,454,455],{},"Creación",": se registra el comprobante para referencia posterior.",[410,458,459,462],{},[413,460,461],{},"Firmado",": el comprobante se firma con el certificado de firma electrónica\npara que el SRI pueda verificar su legitimidad.",[410,464,465,468],{},[413,466,467],{},"Envío al SRI",": el comprobante se envía al SRI para ser procesado.",[410,470,471,474],{},[413,472,473],{},"Consulta de autorización",": tras un período de espera, Taxo consulta la\nautorización del comprobante ante el SRI.",[410,476,477,479],{},[413,478,211],{},": si se proveyó una dirección válida, el comprobante se\nenvía al receptor.",[302,481,482,483,486],{},"El campo ",[319,484,485],{},"estado"," refleja en qué punto del proceso está el comprobante:",[342,488,489,499],{},[345,490,491],{},[348,492,493,496],{},[351,494,495],{},"Estado",[351,497,498],{},"Significado",[361,500,501,511,521,531,541,551],{},[348,502,503,508],{},[366,504,505],{},[319,506,507],{},"RECIBIDO",[366,509,510],{},"El comprobante fue recibido y registrado.",[348,512,513,518],{},[366,514,515],{},[319,516,517],{},"ENVIADO",[366,519,520],{},"El comprobante fue enviado al SRI.",[348,522,523,528],{},[366,524,525],{},[319,526,527],{},"AUTORIZADO",[366,529,530],{},"El SRI autorizó el comprobante.",[348,532,533,538],{},[366,534,535],{},[319,536,537],{},"NO AUTORIZADO",[366,539,540],{},"El SRI rechazó el comprobante. Revisá los mensajes de la respuesta.",[348,542,543,548],{},[366,544,545],{},[319,546,547],{},"DEVUELTO",[366,549,550],{},"El SRI devolvió el comprobante por errores de estructura.",[348,552,553,558],{},[366,554,555],{},[319,556,557],{},"ERROR",[366,559,560],{},"Ocurrió un error durante el proceso de emisión.",[562,563,564],"note",{},[302,565,566],{},"El proceso lo administramos nosotros. Para emitir un comprobante alcanza con\nenviarlo siguiendo la sección correspondiente de esta documentación.",{"title":568,"searchDepth":569,"depth":570,"links":571},"",1,2,[572,573,574,575],{"id":311,"depth":570,"text":312},{"id":332,"depth":570,"text":333},{"id":401,"depth":570,"text":402},{"id":439,"depth":570,"text":444},null,"Emite comprobantes electrónicos autorizados por el SRI desde tu aplicación con el API de Taxo Facturación.","md",{},{"title":11},{"title":154,"description":577},"ZOMb36BocWZA2cE8oicc_0VLJX013JhWx7xjEqsqn30",[584,586],{"title":150,"path":151,"stem":152,"description":585,"children":-1},"Referencia interactiva de todos los endpoints del API de Extracción, generada desde la especificación OpenAPI de producción.",{"title":167,"path":168,"stem":169,"description":587,"children":-1},"Cabeceras de autenticación, clave del certificado de firma e idempotencia del API de Taxo Facturación.",1790201862774]