{"templateId":"markdown","sharedDataIds":{},"props":{"metadata":{"markdoc":{"tagList":[]},"type":"markdown"},"seo":{"title":"Catálogos SAT","description":"QRwey! API es un API que te permite intenciones de autofactura con QRs para ser leidos en la App de QRwey!.","llmstxt":{"hide":false,"sections":[{"title":"Table of contents","includeFiles":["**/*"],"excludeFiles":[]}],"excludeFiles":[]}},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"catálogos-sat","__idx":0},"children":["Catálogos SAT"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Los ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["catálogos del SAT"]}," proporcionan las claves oficiales necesarias para construir"," ","CFDIs validos. Estos endpoints permiten consultar formas de pago, claves de unidad"," ","y claves de producto/servicio directamente desde el API."]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"formas-de-pago","__idx":1},"children":["Formas de pago"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Obtiene el catálogo completo de formas de pago del SAT."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"endpoint","__idx":2},"children":["Endpoint"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"GET /v1/qrs/sat-catalogs/payment-forms\n"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Host (DEV):"]}]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"https://api-dev.qrwey.com\n"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Host (PROD):"]}]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"https://api.qrwey.com\n"},"children":[]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"headers-requeridos","__idx":3},"children":["Headers requeridos"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"http","header":{"controls":{"copy":{}}},"source":"Authorization: Bearer {{access_token}}\n","lang":"http"},"children":[]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"ejemplo-de-request-dev","__idx":4},"children":["Ejemplo de request (DEV)"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"curl -X GET \"https://api-dev.qrwey.com/v1/qrs/sat-catalogs/payment-forms\" \\\n  -H \"Authorization: Bearer {{access_token}}\"\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"respuesta","__idx":5},"children":["Respuesta"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"[\n  {\n    \"code\": \"01\",\n    \"description\": \"Efectivo\"\n  },\n  {\n    \"code\": \"03\",\n    \"description\": \"Transferencia electrónica de fondos\"\n  },\n  {\n    \"code\": \"04\",\n    \"description\": \"Tarjeta de crédito\"\n  }\n]\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"claves-de-unidad","__idx":6},"children":["Claves de unidad"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Obtiene el catálogo paginado de claves de unidad del SAT con soporte de búsqueda."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"endpoint-1","__idx":7},"children":["Endpoint"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"GET /v1/qrs/sat-catalogs/unit-keys\n"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"headers-requeridos-1","__idx":8},"children":["Headers requeridos"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"http","header":{"controls":{"copy":{}}},"source":"Authorization: Bearer {{access_token}}\n","lang":"http"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"query-params","__idx":9},"children":["Query params"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Parámetro"},"children":["Parámetro"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Descripción"},"children":["Descripción"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["filter"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Texto para filtrar por clave o descripción (default: vacío)"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["page"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Número de página (default: 0)"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["size"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Elementos por página (default: 20)"]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"ejemplo-de-request-dev-1","__idx":10},"children":["Ejemplo de request (DEV)"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"curl -X GET \"https://api-dev.qrwey.com/v1/qrs/sat-catalogs/unit-keys?filter=litro&page=0&size=10\" \\\n  -H \"Authorization: Bearer {{access_token}}\"\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"respuesta-1","__idx":11},"children":["Respuesta"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"content\": [\n    {\n      \"code\": \"LTR\",\n      \"description\": \"Litro\"\n    }\n  ],\n  \"totalElements\": 1,\n  \"totalPages\": 1,\n  \"number\": 0,\n  \"size\": 10\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"productos-y-servicios","__idx":12},"children":["Productos y servicios"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Obtiene el catálogo paginado de claves de producto/servicio del SAT con soporte de búsqueda."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"endpoint-2","__idx":13},"children":["Endpoint"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"GET /v1/qrs/sat-catalogs/product-services\n"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"headers-requeridos-2","__idx":14},"children":["Headers requeridos"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"http","header":{"controls":{"copy":{}}},"source":"Authorization: Bearer {{access_token}}\n","lang":"http"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"query-params-1","__idx":15},"children":["Query params"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Parámetro"},"children":["Parámetro"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Descripción"},"children":["Descripción"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["filter"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Texto para filtrar por clave o descripción (default: vacío)"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["page"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Número de página (default: 0)"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["size"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Elementos por página (default: 20)"]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"ejemplo-de-request-dev-2","__idx":16},"children":["Ejemplo de request (DEV)"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"curl -X GET \"https://api-dev.qrwey.com/v1/qrs/sat-catalogs/product-services?filter=gasolina&page=0&size=10\" \\\n  -H \"Authorization: Bearer {{access_token}}\"\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"respuesta-2","__idx":17},"children":["Respuesta"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"content\": [\n    {\n      \"code\": \"15101515\",\n      \"description\": \"Gasolina\"\n    }\n  ],\n  \"totalElements\": 1,\n  \"totalPages\": 1,\n  \"number\": 0,\n  \"size\": 10\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"permisos-de-operación-eds","__idx":18},"children":["Permisos de operación EDS"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Obtiene el catálogo de permisos de operación de estaciones de servicio del SAT."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"endpoint-3","__idx":19},"children":["Endpoint"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"GET /v1/qrs/sat-catalogs/eds-operating-permits\n"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"headers-requeridos-3","__idx":20},"children":["Headers requeridos"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"http","header":{"controls":{"copy":{}}},"source":"Authorization: Bearer {{access_token}}\n","lang":"http"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"ejemplo-de-request-dev-3","__idx":21},"children":["Ejemplo de request (DEV)"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"curl -X GET \"https://api-dev.qrwey.com/v1/qrs/sat-catalogs/eds-operating-permits\" \\\n  -H \"Authorization: Bearer {{access_token}}\"\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"respuesta-3","__idx":22},"children":["Respuesta"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"[\n  {\n    \"type\": \"PER01\",\n    \"description\": \"Expendio en estaciones de servicio de petrolíferos\",\n    \"nomenclature\": \"PL/(N Consecutivo)/EXP/ES/(Año)\",\n    \"regex\": \"PL/[0-9]{3,20}/EXP/ES/[0-9]{4}\"\n  },\n  {\n    \"type\": \"PER03\",\n    \"description\": \"Distribución por otros medios distintos a ducto\",\n    \"nomenclature\": \"PL/(N Consecutivo)/DIS/OM/(Año)\",\n    \"regex\": \"PL/[0-9]{3,20}/DIS/OM/[0-9]{4}\"\n  }\n]\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"motivos-de-cancelación","__idx":23},"children":["Motivos de cancelación"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Obtiene el catálogo de motivos de cancelación de CFDI del SAT."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"endpoint-4","__idx":24},"children":["Endpoint"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"GET /v1/qrs/sat-catalogs/cancellation-reasons\n"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"headers-requeridos-4","__idx":25},"children":["Headers requeridos"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"http","header":{"controls":{"copy":{}}},"source":"Authorization: Bearer {{access_token}}\n","lang":"http"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"ejemplo-de-request-dev-4","__idx":26},"children":["Ejemplo de request (DEV)"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"curl -X GET \"https://api-dev.qrwey.com/v1/qrs/sat-catalogs/cancellation-reasons\" \\\n  -H \"Authorization: Bearer {{access_token}}\"\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"respuesta-4","__idx":27},"children":["Respuesta"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"[\n  {\n    \"code\": \"01\",\n    \"description\": \"Comprobantes emitidos con errores con relación\"\n  },\n  {\n    \"code\": \"02\",\n    \"description\": \"Comprobantes emitidos con errores sin relación\"\n  },\n  {\n    \"code\": \"03\",\n    \"description\": \"No se llevó a cabo la operación\"\n  },\n  {\n    \"code\": \"04\",\n    \"description\": \"Operación nominativa relacionada en la factura global\"\n  }\n]\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"errores-comunes","__idx":28},"children":["Errores comunes"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Código"},"children":["Código"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Motivo"},"children":["Motivo"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["401"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Token inválido o expirado"]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Consulta: ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/guides/error-handling"},"children":["Manejo de errores"]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"buenas-prácticas","__idx":29},"children":["Buenas prácticas"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Usa el parámetro ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["filter"]}," para buscar claves específicas en lugar de recorrer todo el catálogo"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Cachea los resultados de formas de pago ya que cambian con poca frecuencia"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Para claves de unidad y producto/servicio, usa paginación para manejar el gran volumen de registros"]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"qué-sigue","__idx":30},"children":["¿Qué sigue?"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Timbra un CFDI con las claves correctas: ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/guides/stamp-cfdi"},"children":["Timbrar CFDI 4.0"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Consulta planes de facturación: ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/guides/budget-plans"},"children":["Planes de facturación"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Vuelve al índice: ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/guides/customer-portal"},"children":["Gestión de Clientes"]}]}]}]},"headings":[{"value":"Catálogos SAT","id":"catálogos-sat","depth":1},{"value":"Formas de pago","id":"formas-de-pago","depth":2},{"value":"Endpoint","id":"endpoint","depth":3},{"value":"Headers requeridos","id":"headers-requeridos","depth":3},{"value":"Ejemplo de request (DEV)","id":"ejemplo-de-request-dev","depth":3},{"value":"Respuesta","id":"respuesta","depth":3},{"value":"Claves de unidad","id":"claves-de-unidad","depth":2},{"value":"Endpoint","id":"endpoint-1","depth":3},{"value":"Headers requeridos","id":"headers-requeridos-1","depth":3},{"value":"Query params","id":"query-params","depth":3},{"value":"Ejemplo de request (DEV)","id":"ejemplo-de-request-dev-1","depth":3},{"value":"Respuesta","id":"respuesta-1","depth":3},{"value":"Productos y servicios","id":"productos-y-servicios","depth":2},{"value":"Endpoint","id":"endpoint-2","depth":3},{"value":"Headers requeridos","id":"headers-requeridos-2","depth":3},{"value":"Query params","id":"query-params-1","depth":3},{"value":"Ejemplo de request (DEV)","id":"ejemplo-de-request-dev-2","depth":3},{"value":"Respuesta","id":"respuesta-2","depth":3},{"value":"Permisos de operación EDS","id":"permisos-de-operación-eds","depth":2},{"value":"Endpoint","id":"endpoint-3","depth":3},{"value":"Headers requeridos","id":"headers-requeridos-3","depth":3},{"value":"Ejemplo de request (DEV)","id":"ejemplo-de-request-dev-3","depth":3},{"value":"Respuesta","id":"respuesta-3","depth":3},{"value":"Motivos de cancelación","id":"motivos-de-cancelación","depth":2},{"value":"Endpoint","id":"endpoint-4","depth":3},{"value":"Headers requeridos","id":"headers-requeridos-4","depth":3},{"value":"Ejemplo de request (DEV)","id":"ejemplo-de-request-dev-4","depth":3},{"value":"Respuesta","id":"respuesta-4","depth":3},{"value":"Errores comunes","id":"errores-comunes","depth":2},{"value":"Buenas prácticas","id":"buenas-prácticas","depth":2},{"value":"¿Qué sigue?","id":"qué-sigue","depth":2}],"frontmatter":{"title":"Catálogos SAT","description":"Consultar catálogos del SAT (formas de pago, claves de unidad, productos y servicios) en QRwey!","seo":{"title":"Catálogos SAT"}},"lastModified":"2026-04-22T23:50:55.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/guides/sat-catalogs","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}