Skip to main content

​
GET /api/sat/:id

Retrieves complete details for a specific SAT product or service by its code. Use this endpoint to get full information about a product/service identified during search.

​
Authentication

This endpoint requires authentication. Include your access token in the request cookies.

​
Path Parameters

​
id
string
required
SAT product/service code (e.g., “80141600”)

​
Response

​
id
string
required
SAT product/service code
​
descripcion
string
required
Description of the product or service
​
incluir_iva_trasladado
string
required
IVA requirement. Options: Sí, No, Opcional
​
incluir_ieps_trasladado
string
required
IEPS requirement. Options: Sí, No, Opcional
​
complemento_que_debe_incluir
string
Required complement for invoicing. Null if none required
​
fecha_inicio_vigencia
string
required
Start date of validity (ISO 8601 format)
​
fecha_fin_vigencia
string
End date of validity (ISO 8601 format). Null if still valid
​
estimulo_franja_fronteriza
string
required
Border zone stimulus information
​
palabras_similares
string
Similar keywords for search optimization. Null if none
​
created_at
string
required
Record creation timestamp (ISO 8601 format)
​
updated_at
string
required
Record last update timestamp (ISO 8601 format)

​
Example Request

curl -X GET "https://api.contafy.com/api/sat/80141600" \
  -H "Cookie: access_token=your_access_token"

​
Example Response

{
  "id": "80141600",
  "descripcion": "Servicios de consultoría de negocios y administración corporativa",
  "incluir_iva_trasladado": "Sí",
  "incluir_ieps_trasladado": "No",
  "complemento_que_debe_incluir": null,
  "fecha_inicio_vigencia": "2017-01-01T00:00:00Z",
  "fecha_fin_vigencia": null,
  "estimulo_franja_fronteriza": "No aplica",
  "palabras_similares": "consultoría empresarial asesoría negocios administración",
  "created_at": "2023-01-15T10:00:00Z",
  "updated_at": "2023-01-15T10:00:00Z"
}

​
Use Cases

  • Retrieve full details after selecting from search results
  • Verify product/service information before creating an invoice
  • Display complete tax requirements for a specific code
  • Validate that a product/service code is still valid

​
Error Responses

​
401 Unauthorized
error
Authentication required or token expired
{
  "error": "Unauthorized",
  "message": "Authentication required"
}
​
404 Not Found
error
SAT product/service code not found
{
  "error": "Not Found",
  "message": "SAT product/service not found"
}
​
400 Bad Request
error
Invalid product/service code format
{
  "error": "Bad Request",
  "message": "Invalid SAT product/service code format"
}
​
500 Internal Server Error
error
Server error occurred
{
  "error": "Internal Server Error",
  "message": "An unexpected error occurred"
}
Check the fecha_fin_vigencia field. If null, the product/service is currently valid. If it has a date, verify it hasn’t expired.