Skip to main content

​
¿Qué es una empresa?

Una empresa es el emisor de tus CFDIs — la entidad fiscal registrada ante el SAT que aparecerá en el campo <cfdi:Emisor> de cada factura. Cada empresa tiene su propio RFC, régimen fiscal y Certificado de Sello Digital (CSD). Puedes tener múltiples empresas en una sola cuenta. Todos los CFDIs timbrados se asocian a una empresa específica.

​
Listar empresas

GET https://api.ipsofactura.com/empresas

​
Headers

HeaderValor
AuthorizationBearer {tu_api_key}

​
Query params

ParamTipoDefaultDescripción
include_certificadosbooleanfalseSi es true, incluye el detalle de los CSD de cada empresa.

​
Ejemplos de uso

import requests

# Listar empresas (sin certificados)
response = requests.get(
    "https://api.ipsofactura.com/empresas",
    headers={"Authorization": "Bearer {tu_api_key}"},
)

data = response.json()
for empresa in data["empresas"]:
    print(f"{empresa['rfc']} — {empresa['nombre_fiscal']} (id: {empresa['id']})")

​
Con certificados incluidos

response = requests.get(
    "https://api.ipsofactura.com/empresas",
    headers={"Authorization": "Bearer {tu_api_key}"},
    params={"include_certificados": "true"},
)

data = response.json()
for empresa in data["empresas"]:
    print(f"{empresa['rfc']}")
    for cert in empresa.get("certificados", []):
        print(f"  CSD {cert['numero_certificado']} — válido hasta {cert['fecha_fin']} ({cert['estado']})")

​
Response 200

{
  "empresas": [
    {
      "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
      "rfc": "AAA010101AAA",
      "nombre_fiscal": "Empresa de Pruebas SA de CV",
      "codigo_postal": "06600"
    }
  ]
}
Con include_certificados=true, cada empresa incluye un array certificados: 
{
  "empresas": [
    {
      "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
      "rfc": "AAA010101AAA",
      "nombre_fiscal": "Empresa de Pruebas SA de CV",
      "codigo_postal": "06600",
      "certificados": [
        {
          "id": "c3d4e5f6-a1b2-7890-abcd-ef1234567890",
          "numero_certificado": "00001000000504465028",
          "fecha_fin": "2027-08-15",
          "estado": "VALIDO",
          "fecha_creacion": "2026-01-10T12:00:00Z"
        }
      ]
    }
  ]
}
CampoTipoDescripción
idstringUUID de la empresa en Ipsofactura. Úsalo en los endpoints de certificados.
rfcstringRFC del emisor tal como está registrado ante el SAT.
nombre_fiscalstringRazón social del emisor.
codigo_postalstringCódigo postal del domicilio fiscal.
certificadosarrayLista de CSDs registrados. Solo presente con include_certificados=true.
certificados[].estadostringVALIDO o VENCIDO.

​
Errores

​
Sin acceso (403)

{
  "error": "ACCESS_DENIED",
  "message": "Tu API key no tiene acceso a este recurso.",
  "status": 403
}

​
Tabla de errores

StatusCódigoDescripción
403ACCESS_DENIEDTu API key no tiene acceso a este recurso.
Para registrar una nueva empresa, contacta a tu ejecutivo de cuenta o escríbenos a soporte@ipsofactura.com. La empresa quedará activa en menos de 24 horas.