Empresa

GET`/api/v1/empresa`

Retorna el perfil completo de tu empresa, incluyendo tarifas base, configuración COD y tarifas personalizadas por municipio. Usa este endpoint para inicializar tu sistema con la configuración actual de tu cuenta.

Ejemplo

curl


curl https://api.tpcxpress.com/api/v1/empresa \
  -H "Authorization: Bearer TOKEN"

JavaScript


const res = await fetch('https://api.tpcxpress.com/api/v1/empresa', {
  headers: { 'Authorization': `Bearer ${process.env.TPC_API_TOKEN}` },
})
const { data } = await res.json()

Python


import httpx, os
 
client = httpx.Client(
    base_url="https://api.tpcxpress.com/api/v1",
    headers={"Authorization": f"Bearer {os.environ['TPC_API_TOKEN']}"},
)
data = client.get("/empresa").raise_for_status().json()["data"]

Respuesta 200


{
  "success": true,
  "data": {
    "id": "cluuid-empresa-123",
    "nombre": "Mi Empresa S.A.",
    "correo": "ops@miempresa.com",
    "telefono": "22221234",
    "ciudadOrigen": "Guatemala",
    "costoEntrega": 30.00,
    "porcentajeCOD": 5.0,
    "diasEntregaMaximos": 3,
    "tarifasPersonalizadas": [
      {
        "municipio": "Mixco",
        "costo": 25.00
      },
      {
        "municipio": "Villa Nueva",
        "costo": 28.00
      }
    ]
  }
}

Campos de respuesta

Campo	Tipo	Descripción
`id`	string	Identificador único de tu empresa
`nombre`	string	Nombre comercial registrado
`correo`	string	Correo de contacto
`telefono`	string	Teléfono de contacto
`ciudadOrigen`	string	Ciudad desde donde TPC recolecta tus paquetes
`costoEntrega`	number	Tarifa base de envío en Quetzales (aplica a municipios sin tarifa personalizada)
`porcentajeCOD`	number \| null	Comisión que TPC retiene por cobros contra entrega (%)
`diasEntregaMaximos`	integer	SLA de entrega en días hábiles
`tarifasPersonalizadas`	array	Tarifas negociadas por municipio (sobreescriben `costoEntrega`)