Skip to main content

​
GET /api/sat/search

Busca productos y servicios en el catálogo SAT. Soporta búsqueda básica y búsqueda con IA según tu plan.

​
Autenticación

Requiere autenticación con Bearer token.

​
Query Parameters

​
query
string
Texto de búsqueda para encontrar productos/servicios en el catálogo.
​
incluir_iva_trasladado
string
Filtrar por productos que incluyen IVA trasladado. Valores: "SI" o "NO".
​
incluir_ieps_trasladado
string
Filtrar por productos que incluyen IEPS trasladado. Valores: "SI" o "NO".
​
limit
integer
default:50
Número de resultados a retornar. Debe estar entre 1 y 100.
​
offset
integer
default:0
Número de resultados a saltar para paginación. Debe ser mayor o igual a 0.
​
useAI
boolean
default:false
Si es true, usa búsqueda con IA (cuenta para límite mensual). Si es false, usa búsqueda básica.

​
Response

​
items
array
Lista de productos/servicios encontrados.
​
total
integer
Número total de resultados encontrados.
​
limit
integer
Límite aplicado a la consulta.
​
offset
integer
Offset aplicado a la consulta.
​
planInfo
object
Información sobre los límites y características del plan actual.

​
Códigos de Estado

  • 200 - Búsqueda exitosa
  • 400 - Parámetros inválidos
  • 401 - No autenticado
  • 403 - Límite de plan alcanzado (para búsqueda IA)
  • 500 - Error del servidor
curl --request GET \
  --url 'https://api.contafy.com/api/sat/search?query=computadora&limit=10' \
  --header 'Authorization: Bearer YOUR_TOKEN'

{
  "items": [
    {
      "clave_prod_serv": "43211500",
      "descripcion": "Computadoras personales",
      "incluir_iva_trasladado": "Sí",
      "incluir_ieps_trasladado": "No"
    },
    {
      "clave_prod_serv": "43211503",
      "descripcion": "Computadoras portátiles",
      "incluir_iva_trasladado": "Sí",
      "incluir_ieps_trasladado": "No"
    }
  ],
  "total": 2,
  "limit": 10,
  "offset": 0,
  "planInfo": {
    "maxResults": 50,
    "aiSearchesRemaining": 45,
    "aiSearchesLimit": 50,
    "aiSearchesUsed": 5,
    "hasAIExplanations": true,
    "hasHistory": true,
    "hasFavorites": true,
    "hasAlerts": false,
    "hasLearning": true,
    "hasAdvancedRanking": true
  }
}

Build docs developers (and LLMs) love

Get started for freeTalk to us