Buscar catálogo de productos SAT
Busca claves oficiales de productos y servicios del catálogo del SAT.
search_sat_product_catalogPropósito
- Usar cuando
- Necesitas una clave SAT para una partida personalizada.
- No usar cuando
- Necesitas un producto o configuración de la organización.
- Permisos requeridos
- Efectos secundarios
- Ninguno
- Idempotencia
- Idempotente
Esquema de entrada
JSON Schema{ "type": "object", "properties": { "query": { "type": "string", "minLength": 2, "maxLength": 256 }, "cursor": { "type": "string", "minLength": 1, "maxLength": 16384 }, "limit": { "type": "integer", "minimum": 1, "maximum": 50 } }, "required": [ "query" ], "$schema": "http://json-schema.org/draft-07/schema#", "additionalProperties": false}Esquema de salida
JSON Schema{ "type": "object", "properties": { "data": { "type": "object", "properties": { "data": { "type": "array", "items": { "type": "object", "properties": { "key": { "type": "string" }, "description": { "type": "string" } }, "required": [ "key", "description" ], "additionalProperties": false } }, "pagination": { "type": "object", "properties": { "nextCursor": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "hasMore": { "type": "boolean" } }, "required": [ "nextCursor", "hasMore" ], "additionalProperties": false } }, "required": [ "data", "pagination" ], "additionalProperties": false }, "error": { "$schema": "http://json-schema.org/draft-07/schema#", "type": "object", "properties": { "code": { "enum": [ "validation_error", "unauthenticated", "forbidden", "payment_required", "not_found", "method_not_allowed", "conflict", "idempotency_conflict", "operation_in_progress", "recovery_required", "migration_required", "rate_limited", "provider_unavailable", "internal" ] }, "message": { "type": "string" }, "details": { "type": "object", "properties": { "document": { "type": "object", "properties": { "documentRef": { "type": "string", "pattern": "^(invoice|withholding|sales_receipt|declaration|tax_compliance_opinion|sales_receipt_refund):.+$" }, "editable": { "type": "boolean" } }, "required": [ "documentRef", "editable" ], "additionalProperties": false }, "issues": { "type": "array", "items": { "type": "object", "properties": { "path": { "type": "array", "items": { "anyOf": [ { "type": "string" }, { "type": "number" } ] } }, "message": { "type": "string" }, "code": { "type": "string" } }, "required": [ "path", "message" ], "additionalProperties": false } }, "retryable": { "type": "boolean" }, "retryAfterSeconds": { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 }, "reason": { "type": "string" }, "balanceMinor": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "topUpUrl": { "type": "string" } }, "additionalProperties": false } }, "required": [ "code", "message" ], "additionalProperties": false } }, "$schema": "http://json-schema.org/draft-07/schema#", "additionalProperties": false, "oneOf": [ { "required": [ "data" ] }, { "required": [ "error" ] } ]}Flujo relacionado
Consulta los flujos canónicos en Inicio rápidoHerramientas relacionadas
Leer configuración
Busca o recupera sucursales y campos de recibos de la organización. Si un campo indica valuesComplete: false, usa operation: values con kind: sales_receipt_field y entryId, desde la primera página, para recuperar todas sus opciones mediante cursor.
Guardar configuración
Crea o actualiza una sucursal o campo de recibo de la organización. Crear un campo con un nombre normalizado existente devuelve conflict; consúltalo con get_configuration y usa operation: update con su entryId. Al actualizar un campo, omite values para conservar sus opciones; un arreglo enviado las reemplaza todas y un arreglo vacío las borra. Nunca uses una vista previa incompleta como reemplazo.