Requisitos por País

Descripción General

Los endpoints de requisitos por país ayudan a los desarrolladores a comprender qué campos son obligatorios para la creación de entidades en diferentes países. Cada país tiene reglas de validación específicas, formatos de identificación fiscal y campos requeridos. Esto elimina el método de prueba y error al crear entidades y proporciona una guía clara sobre qué datos son necesarios. Para empresas, los campos de domicilio fiscal (p. ej. domicilioFiscal, direccion, address) son opcionales al crear. Podés crear con identificación fiscal y razón social, y completar la dirección después mediante edición manual o enrichments del país (p. ej. ARCA en Argentina).

Países Soportados

gu1 actualmente soporta 16 países con validación integral:

🇦🇷 Argentina

Validación de CUIT

🇧🇷 Brasil

Validación de CNPJ

🇲🇽 México

Validación de RFC

🇨🇱 Chile

Validación de RUT

🇨🇴 Colombia

Validación de NIT

🇵🇪 Perú

Validación de RUC

🇺🇾 Uruguay

Validación de RUT

🇪🇨 Ecuador

Validación de RUC

🇵🇾 Paraguay

Validación de RUC

🇧🇴 Bolivia

Validación de NIT

🇻🇪 Venezuela

Validación de RIF

🇺🇸 Estados Unidos

Validación de EIN

🇨🇦 Canadá

Validación de BN

🇪🇸 España

Validación de CIF

🇵🇹 Portugal

Validación de NIPC

🇪🇪 Estonia

Validación de Registrikood

Obtener Todos los Países

GET http://api.gu1.ai/entities/country-requirements

Recupere una lista de todos los países soportados.

Ejemplo de Respuesta

{
  "success": true,
  "countries": [
    { "code": "AR", "name": "Argentina" },
    { "code": "BR", "name": "Brazil" },
    { "code": "MX", "name": "Mexico" },
    { "code": "US", "name": "United States" },
    ...
  ],
  "total": 16
}

Obtener Requisitos Específicos por País

GET http://api.gu1.ai/entities/country-requirements/:countryCode

Obtenga requisitos de validación detallados para un país específico.

Parámetros de Ruta

string

required

Código de país ISO 3166-1 alpha-2 (por ejemplo, “AR”, “BR”, “US”)

Campos de Respuesta

boolean

Indica si la solicitud fue exitosa

object

Detalles de validación del país

Show propiedades de country

string

Código ISO del país

string

Nombre del país

string

Nombre local para la identificación fiscal (por ejemplo, “CUIT”, “CNPJ”, “RFC”)

string

Patrón de expresión regular para la validación de identificación fiscal

array

Lista de nombres de campos de atributos requeridos

array

Lista de nombres de campos de atributos opcionales. Para empresas, incluye campos de domicilio fiscal que pueden completarse después.

array

Lista de registros oficiales para este país

object

Ejemplo de carga útil de solicitud

Show propiedades de documentation

object

Ejemplo completo de cómo crear una entidad para este país

Ejemplos

Obtener Requisitos de Argentina

curl http://api.gu1.ai/entities/country-requirements/AR \
  -H "Authorization: Bearer YOUR_API_KEY"

const response = await fetch('http://api.gu1.ai/entities/country-requirements/AR', {
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY'
  }
});

const data = await response.json();
console.log(data.country);

import requests

response = requests.get(
    'http://api.gu1.ai/entities/country-requirements/AR',
    headers={'Authorization': 'Bearer YOUR_API_KEY'}
)

requirements = response.json()
print(requirements['country'])

Ejemplo de Respuesta

{
  "success": true,
  "country": {
    "code": "AR",
    "name": "Argentina",
    "taxIdName": "CUIT",
    "taxIdFormat": "^\\d{2}-\\d{8}-\\d{1}$",
    "requiredFields": [
      "cuit",
      "razonSocial"
    ],
    "optionalFields": [
      "domicilioFiscal",
      "iibb",
      "actividadPrincipal",
      "fechaInicioActividades"
    ],
    "registries": [
      "AFIP",
      "IGJ",
      "RPC"
    ]
  },
  "documentation": {
    "example": {
      "type": "company",
      "externalId": "company_123",
      "name": "Example Company",
      "countryCode": "AR",
      "taxId": "Example CUIT",
      "attributes": {
        "cuit": "Example cuit",
        "razonSocial": "Example razonSocial",
        "domicilioFiscal": "Example domicilioFiscal"
      }
    }
  }
}

Ejemplos Específicos por País

🇦🇷 Argentina (CUIT)

{
  "type": "company",
  "externalId": "company_ar_001",
  "name": "Tech Solutions Argentina",
  "countryCode": "AR",
  "taxId": "30-71234567-8",
  "attributes": {
    "cuit": "30-71234567-8",
    "razonSocial": "Tech Solutions S.A.",
    "domicilioFiscal": "Av. Corrientes 1234, CABA",
    "iibb": "901-123456-7",
    "actividadPrincipal": "Desarrollo de Software"
  }
}

Creación mínima de empresa (domicilio opcional):

{
  "type": "company",
  "externalId": "company_ar_minimal",
  "name": "Tech Solutions Argentina",
  "countryCode": "AR",
  "taxId": "30-71234567-8",
  "attributes": {
    "cuit": "30-71234567-8",
    "razonSocial": "Tech Solutions S.A."
  }
}

🇧🇷 Brasil (CNPJ)

{
  "type": "company",
  "externalId": "company_br_001",
  "name": "Tech Solutions Brasil",
  "countryCode": "BR",
  "taxId": "12.345.678/0001-90",
  "attributes": {
    "cnpj": "12.345.678/0001-90",
    "razaoSocial": "Tech Solutions Ltda",
    "enderecoFiscal": "Av. Paulista, 1000 - São Paulo, SP",
    "inscricaoEstadual": "123.456.789.012",
    "cnae": "6201-5/00"
  }
}

🇲🇽 México (RFC)

{
  "type": "company",
  "externalId": "company_mx_001",
  "name": "Tech Solutions México",
  "countryCode": "MX",
  "taxId": "TSM980101ABC",
  "attributes": {
    "rfc": "TSM980101ABC",
    "razonSocial": "Tech Solutions S.A. de C.V.",
    "domicilioFiscal": "Av. Reforma 123, Ciudad de México",
    "regimenFiscal": "601"
  }
}

🇺🇸 Estados Unidos (EIN)

{
  "type": "company",
  "externalId": "company_us_001",
  "name": "Tech Solutions Inc",
  "countryCode": "US",
  "taxId": "12-3456789",
  "attributes": {
    "ein": "12-3456789",
    "legalName": "Tech Solutions Inc.",
    "address": "123 Main St, San Francisco, CA 94102",
    "stateOfIncorporation": "Delaware",
    "naicsCode": "541511"
  }
}

🇪🇸 España (CIF)

{
  "type": "company",
  "externalId": "company_es_001",
  "name": "Tech Solutions España",
  "countryCode": "ES",
  "taxId": "A12345678",
  "attributes": {
    "cif": "A12345678",
    "razonSocial": "Tech Solutions S.L.",
    "direccionFiscal": "Calle Gran Vía 1, Madrid",
    "cnae": "6201"
  }
}

Respuestas de Error

404 - País No Soportado

{
  "success": false,
  "error": {
    "code": "COUNTRY_NOT_SUPPORTED",
    "message": "Country code 'XX' is not supported",
    "details": {
      "countryCode": "XX",
      "supportedCountries": ["AR", "BR", "MX", ...]
    }
  }
}

Mejores Prácticas

Consultar Antes de Crear

Siempre consulte los requisitos del país antes de crear entidades para asegurarse de recopilar todos los datos necesarios de sus usuarios de antemano.

Almacenar en Caché los Requisitos

Los requisitos por país rara vez cambian. Considere almacenarlos en caché en su aplicación para reducir las llamadas a la API.

Validar del Lado del Cliente

Use el patrón regex de taxIdFormat para validar identificaciones fiscales en el lado del cliente antes de enviarlas a la API.

Localizar Nombres de Campos

Muestre los nombres de campos en el idioma del usuario. La API devuelve nombres de campos locales (por ejemplo, “razonSocial” para Argentina en lugar de “legalName”).

​Descripción General

​Países Soportados

🇦🇷 Argentina

🇧🇷 Brasil

🇲🇽 México

🇨🇱 Chile

🇨🇴 Colombia

🇵🇪 Perú

🇺🇾 Uruguay

🇪🇨 Ecuador

🇵🇾 Paraguay

🇧🇴 Bolivia

🇻🇪 Venezuela

🇺🇸 Estados Unidos

🇨🇦 Canadá

🇪🇸 España

🇵🇹 Portugal

🇪🇪 Estonia

​Obtener Todos los Países

​Ejemplo de Respuesta

​Obtener Requisitos Específicos por País

​Parámetros de Ruta

​Campos de Respuesta

​Ejemplos

​Obtener Requisitos de Argentina

​Ejemplo de Respuesta

​Ejemplos Específicos por País

​🇦🇷 Argentina (CUIT)

​🇧🇷 Brasil (CNPJ)

​🇲🇽 México (RFC)

​🇺🇸 Estados Unidos (EIN)

​🇪🇸 España (CIF)

​Respuestas de Error

​404 - País No Soportado

​Mejores Prácticas

​Próximos Pasos

Crear Entidad

Validar Identificaciones Fiscales

Descripción General

Países Soportados

Obtener Todos los Países

Ejemplo de Respuesta

Obtener Requisitos Específicos por País

Parámetros de Ruta

Campos de Respuesta

Ejemplos

Obtener Requisitos de Argentina

Ejemplo de Respuesta

Ejemplos Específicos por País

🇦🇷 Argentina (CUIT)

🇧🇷 Brasil (CNPJ)

🇲🇽 México (RFC)

🇺🇸 Estados Unidos (EIN)

🇪🇸 España (CIF)

Respuestas de Error

404 - País No Soportado

Mejores Prácticas

Próximos Pasos