{"activeVersionTag":"latest","latestAvailableVersionTag":"latest","collection":{"info":{"_postman_id":"da9a5a94-8e8f-4863-a18e-1a71e9caa420","name":"EMITE - Referencia de la API","description":"## ¡BIENVENIDO!\n\nBienvenido a la documentación de nuestros servicios de certificación. En esta página encontrarás los recursos disponibles en nuestro servicio así como actualizaciones y ejemplos de uso en distintos lenguajes. Si deseas probar nuestros servicios en un ambiente de integración _(staging)_, [ponte en contacto con nosotros](https://mailto:clientes@emite.mx).\n\n¡Nos encanta tenerte aqui!\n\n### Nosotros\n\nEMITE es una organización visionaria y emprendedora, que busca apoyar a todas las personas, empresas y corporaciones que requieren de servicios de tecnología en materia de comprobación fiscal digital. EMITE cuenta con la certificación por parte del SAT, para poder timbrar Comprobantes Fiscales Digitales a través de Internet (**CFDI**), con el número de autorización [56080](https://www.gob.mx/sat/acciones-y-programas/emite-soluciones-fiscales-digitales).\n\nConoce un poco más de nosotros en: [https://www.emite.mx/conocenos](https://www.emite.mx/wp-content/uploads/Emite-Conoce-nuestros-servicios-2024-1.pdf)\n\n### Arquitectura\n\nNuestra misión es diseñar soluciones sencillas, rápidas y seguras que ayuden a nuestros clientes a crear aplicaciones sofisticadas, con mayor flexibilidad, escalabilidad y fiabilidad que cumplan con los requisitos más exigentes.\n\nHemos puesto nuestro mayor esfuerzo en _I+D_ para adoptar las tecnologías más innovadoras. Con una arquitectura totalmente _cloud_ y [<i>serverless</i>](https://aws.amazon.com/es/serverless/), de la mano de [Amazon Web Services](https://aws.amazon.com/es/), buscamos redefinir el concepto de servicios de certificación CFDI en México.\n\nEMITE es [Partner Nivel Select](https://amzn.to/2Jtonmz) de la red de socios de Amazon Web Services.\n\n### Referencia de la API\n\nLa API está basada en el protocolo REST. Nuestra API tiene direcciones URL predecibles orientadas a los recursos. Acepta y devuelve cuerpos de solicitud codificados en JSON y utiliza códigos de respuesta HTTP estándar, autenticación y verbos.\n\nPuedes usar la API en modo de integración apuntando al ambiente _staging_, esto no afecta tus datos en vivo ni interactua con el SAT en producción. La URL base y la autenticación determina si la solicitud está en modo **producción** o _staging_.\n\n### Autenticación\n\nEl proceso de autenticación está basado en el estandar [JSON Web Token](https://es.wikipedia.org/wiki/JSON_Web_Token) que permiten la propagación de identidad y privilegios. El JWT te servirá para identificar cada llamada al servicio de EMITE y garantizarás que nadie pueda obtener acceso a tu información. Cada JWT es configurado para ser utilizado ya sea en modo _staging_ o **producción** y para cada uno de estos modos obtendrás un JWT diferente para llamadas entre servidores.\n\n**Asegúrate de nunca compartir tu JWT ya que este tiene acceso a todos los privilegios de tu cuenta.**\n\nPara autenticarte es necesario configurar la cabecera \"Authorization\" y anteponer la palabra Bearer.\n\n<blockquote><br>-H \"Authorization: Bearer eyJhbGc...\"<br></blockquote>\n\n### Versiones\n\nTodos los cambios que hacemos al API y que son incompatibles con versiones anteriores son liberados en una versión nueva. La versión actual es la **v1**. En caso de hacer un cambio entre versiones, recomendamos probar la aplicación con la nueva versión antes de hacer el cambio completo en tu aplicación.\n\nCuando se soluciona algún error en el sistema, la versión sigue siendo la misma, así que no tendrás qué hacer un cambio de versión salvo sean agregadas funcionalidades nuevas.\n\n### ¿request_id?\n\nTe darás cuenta que en todas las peticiones se regresa el valor \"_request_id_\". Este dato es muy importante para poder levantar incidencias o poder trazabilizar las operaciones que realices y será de mucha utilidad para las operaciones de debuggeo en conjunto. Te recomendamos tenerlo siempre a la mano.","schema":"https://schema.getpostman.com/json/collection/v2.0.0/collection.json","isPublicCollection":false,"owner":"887256","team":5831435,"collectionId":"da9a5a94-8e8f-4863-a18e-1a71e9caa420","publishedId":"S17m1ri8","public":true,"publicUrl":"https://bengala.docs.emite.mx","privateUrl":"https://go.postman.co/documentation/887256-da9a5a94-8e8f-4863-a18e-1a71e9caa420","customColor":{"top-bar":"FFFFFF","right-sidebar":"303030","highlight":"EF5B25"},"documentationLayout":"classic-double-column","version":"8.10.1","publishDate":"2019-03-14T23:57:20.000Z","activeVersionTag":"latest","documentationTheme":"light","metaTags":{},"logos":{}},"statusCode":200},"environments":[],"user":{"authenticated":false,"permissions":{"publish":false}},"run":{"button":{"js":"https://run.pstmn.io/button.js","css":"https://run.pstmn.io/button.css"}},"web":"https://www.getpostman.com/","team":{"logo":"https://res.cloudinary.com/postman/image/upload/t_team_logo_pubdoc/v1/team/31ccc468d894560e6c06942cbcc9424eee2b92fe2faa4a5338597519d92254d1","favicon":"https://emite.mx/favicon.ico"},"isEnvFetchError":false,"languages":"[{\"key\":\"csharp\",\"label\":\"C#\",\"variant\":\"HttpClient\"},{\"key\":\"csharp\",\"label\":\"C#\",\"variant\":\"RestSharp\"},{\"key\":\"curl\",\"label\":\"cURL\",\"variant\":\"cURL\"},{\"key\":\"dart\",\"label\":\"Dart\",\"variant\":\"http\"},{\"key\":\"go\",\"label\":\"Go\",\"variant\":\"Native\"},{\"key\":\"http\",\"label\":\"HTTP\",\"variant\":\"HTTP\"},{\"key\":\"java\",\"label\":\"Java\",\"variant\":\"OkHttp\"},{\"key\":\"java\",\"label\":\"Java\",\"variant\":\"Unirest\"},{\"key\":\"javascript\",\"label\":\"JavaScript\",\"variant\":\"Fetch\"},{\"key\":\"javascript\",\"label\":\"JavaScript\",\"variant\":\"jQuery\"},{\"key\":\"javascript\",\"label\":\"JavaScript\",\"variant\":\"XHR\"},{\"key\":\"c\",\"label\":\"C\",\"variant\":\"libcurl\"},{\"key\":\"nodejs\",\"label\":\"NodeJs\",\"variant\":\"Axios\"},{\"key\":\"nodejs\",\"label\":\"NodeJs\",\"variant\":\"Native\"},{\"key\":\"nodejs\",\"label\":\"NodeJs\",\"variant\":\"Request\"},{\"key\":\"nodejs\",\"label\":\"NodeJs\",\"variant\":\"Unirest\"},{\"key\":\"objective-c\",\"label\":\"Objective-C\",\"variant\":\"NSURLSession\"},{\"key\":\"ocaml\",\"label\":\"OCaml\",\"variant\":\"Cohttp\"},{\"key\":\"php\",\"label\":\"PHP\",\"variant\":\"cURL\"},{\"key\":\"php\",\"label\":\"PHP\",\"variant\":\"Guzzle\"},{\"key\":\"php\",\"label\":\"PHP\",\"variant\":\"HTTP_Request2\"},{\"key\":\"php\",\"label\":\"PHP\",\"variant\":\"pecl_http\"},{\"key\":\"powershell\",\"label\":\"PowerShell\",\"variant\":\"RestMethod\"},{\"key\":\"python\",\"label\":\"Python\",\"variant\":\"http.client\"},{\"key\":\"python\",\"label\":\"Python\",\"variant\":\"Requests\"},{\"key\":\"r\",\"label\":\"R\",\"variant\":\"httr\"},{\"key\":\"r\",\"label\":\"R\",\"variant\":\"RCurl\"},{\"key\":\"ruby\",\"label\":\"Ruby\",\"variant\":\"Net::HTTP\"},{\"key\":\"shell\",\"label\":\"Shell\",\"variant\":\"Httpie\"},{\"key\":\"shell\",\"label\":\"Shell\",\"variant\":\"wget\"},{\"key\":\"swift\",\"label\":\"Swift\",\"variant\":\"URLSession\"}]","languageSettings":[{"key":"csharp","label":"C#","variant":"HttpClient"},{"key":"csharp","label":"C#","variant":"RestSharp"},{"key":"curl","label":"cURL","variant":"cURL"},{"key":"dart","label":"Dart","variant":"http"},{"key":"go","label":"Go","variant":"Native"},{"key":"http","label":"HTTP","variant":"HTTP"},{"key":"java","label":"Java","variant":"OkHttp"},{"key":"java","label":"Java","variant":"Unirest"},{"key":"javascript","label":"JavaScript","variant":"Fetch"},{"key":"javascript","label":"JavaScript","variant":"jQuery"},{"key":"javascript","label":"JavaScript","variant":"XHR"},{"key":"c","label":"C","variant":"libcurl"},{"key":"nodejs","label":"NodeJs","variant":"Axios"},{"key":"nodejs","label":"NodeJs","variant":"Native"},{"key":"nodejs","label":"NodeJs","variant":"Request"},{"key":"nodejs","label":"NodeJs","variant":"Unirest"},{"key":"objective-c","label":"Objective-C","variant":"NSURLSession"},{"key":"ocaml","label":"OCaml","variant":"Cohttp"},{"key":"php","label":"PHP","variant":"cURL"},{"key":"php","label":"PHP","variant":"Guzzle"},{"key":"php","label":"PHP","variant":"HTTP_Request2"},{"key":"php","label":"PHP","variant":"pecl_http"},{"key":"powershell","label":"PowerShell","variant":"RestMethod"},{"key":"python","label":"Python","variant":"http.client"},{"key":"python","label":"Python","variant":"Requests"},{"key":"r","label":"R","variant":"httr"},{"key":"r","label":"R","variant":"RCurl"},{"key":"ruby","label":"Ruby","variant":"Net::HTTP"},{"key":"shell","label":"Shell","variant":"Httpie"},{"key":"shell","label":"Shell","variant":"wget"},{"key":"swift","label":"Swift","variant":"URLSession"}],"languageOptions":[{"label":"C# - HttpClient","value":"csharp - HttpClient - C#"},{"label":"C# - RestSharp","value":"csharp - RestSharp - C#"},{"label":"cURL - cURL","value":"curl - cURL - cURL"},{"label":"Dart - http","value":"dart - http - Dart"},{"label":"Go - Native","value":"go - Native - Go"},{"label":"HTTP - HTTP","value":"http - HTTP - HTTP"},{"label":"Java - OkHttp","value":"java - OkHttp - Java"},{"label":"Java - Unirest","value":"java - Unirest - Java"},{"label":"JavaScript - Fetch","value":"javascript - Fetch - JavaScript"},{"label":"JavaScript - jQuery","value":"javascript - jQuery - JavaScript"},{"label":"JavaScript - XHR","value":"javascript - XHR - JavaScript"},{"label":"C - libcurl","value":"c - libcurl - C"},{"label":"NodeJs - Axios","value":"nodejs - Axios - NodeJs"},{"label":"NodeJs - Native","value":"nodejs - Native - NodeJs"},{"label":"NodeJs - Request","value":"nodejs - Request - NodeJs"},{"label":"NodeJs - Unirest","value":"nodejs - Unirest - NodeJs"},{"label":"Objective-C - NSURLSession","value":"objective-c - NSURLSession - Objective-C"},{"label":"OCaml - Cohttp","value":"ocaml - Cohttp - OCaml"},{"label":"PHP - cURL","value":"php - cURL - PHP"},{"label":"PHP - Guzzle","value":"php - Guzzle - PHP"},{"label":"PHP - HTTP_Request2","value":"php - HTTP_Request2 - PHP"},{"label":"PHP - pecl_http","value":"php - pecl_http - PHP"},{"label":"PowerShell - RestMethod","value":"powershell - RestMethod - PowerShell"},{"label":"Python - http.client","value":"python - http.client - Python"},{"label":"Python - Requests","value":"python - Requests - Python"},{"label":"R - httr","value":"r - httr - R"},{"label":"R - RCurl","value":"r - RCurl - R"},{"label":"Ruby - Net::HTTP","value":"ruby - Net::HTTP - Ruby"},{"label":"Shell - Httpie","value":"shell - Httpie - Shell"},{"label":"Shell - wget","value":"shell - wget - Shell"},{"label":"Swift - URLSession","value":"swift - URLSession - Swift"}],"layoutOptions":[{"value":"classic-single-column","label":"Single Column"},{"value":"classic-double-column","label":"Double Column"}],"versionOptions":[],"environmentOptions":[{"value":"0","label":"No Environment"}],"canonicalUrl":"https://bengala.docs.emite.mx/view/metadata/S17m1ri8"}