Get SAT Product Details

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

string

required

SAT product/service code (e.g., “80141600”)

Response

string

required

SAT product/service code

string

required

Description of the product or service

string

required

IVA requirement. Options: Sí, No, Opcional

string

required

IEPS requirement. Options: Sí, No, Opcional

string

Required complement for invoicing. Null if none required

string

required

Start date of validity (ISO 8601 format)

string

End date of validity (ISO 8601 format). Null if still valid

string

required

Border zone stimulus information

string

Similar keywords for search optimization. Null if none

string

required

Record creation timestamp (ISO 8601 format)

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

error

Authentication required or token expired

{
  "error": "Unauthorized",
  "message": "Authentication required"
}

error

SAT product/service code not found

{
  "error": "Not Found",
  "message": "SAT product/service not found"
}

error

Invalid product/service code format

{
  "error": "Bad Request",
  "message": "Invalid SAT product/service code format"
}

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.

Authentication

Profiles

Invoices

Expenses

Subscription

SAT Search

Get SAT Product Details

GET /api/sat/:id

Authentication

Path Parameters

Response

Example Request

Example Response

Use Cases

Error Responses

​GET /api/sat/:id

​Authentication

​Path Parameters

​Response

​Example Request

​Example Response

​Use Cases

​Error Responses

GET /api/sat/:id

Authentication

Path Parameters

Response

Example Request

Example Response

Use Cases

Error Responses