B2B API — Obtener información de la empresa (REST)

Support DQE
Support DQE
  • Actualización

Utilice este endpoint para recuperar información legal y administrativa detallada sobre una empresa seleccionada.

Documentación relacionada de la B2B API RESTful:

Solicitud GET

Forma comprimida

GET https://{SERVER_ADDRESS}/{VERSION}/infosr/?SEARCH_REF={SEARCHREF}&Country={COUNTRY_CODE}&Licence={LICENCE_CODE}&extension={EXTENSION}

Simplemente reemplace los elementos entre llaves con su información.

Parámetro Descripción Obligatorio/Opcional
SERVER_ADDRESS Dirección del servidor DQE que procesará los datos. Obligatorio
VERSION Versión de la API. Ejemplo: v1 Obligatorio
Licence Número asignado como su código de licencia. Obligatorio
SEARCH_REF Referencia de búsqueda devuelta por el endpoint Lookup. Obligatorio
Country Código de país ISO de 3 letras. Obligatorio
extension Si se establece en all, devuelve la forma extendida (JSON completo). Opcional. Valor por defecto: 1
NAF25 Obtener o no el nuevo valor del Sic Code en Francia: True / False Opcional. Valor por defecto: False

Forma extendida

GET https://{SERVER_ADDRESS}/{VERSION}/infocnum/CompanyNumber={INPUT}/?&Country={COUNTRY_CODE}&Licence={LICENCE_CODE}
Parámetro Descripción Obligatorio/Opcional
SERVER_ADDRESS Dirección del servidor DQE que procesará los datos. Obligatorio
VERSION Versión de la API. Ejemplo: v1 Obligatorio
Licence Número asignado como su código de licencia. Obligatorio
CompanyNumber Número SIRET de la empresa. Obligatorio
Country Código de país ISO de 3 letras. Obligatorio
NAF25 Obtener o no el nuevo valor del Sic Code en Francia: True / False Opcional. Valor por defecto: False

Solicitud POST

Añada los parámetros siguientes en el cuerpo usando x-www-form-urlencoded.

Forma comprimida

POST https://{SERVER_ADDRESS}/{VERSION}/infosr/
Parámetro Descripción Obligatorio/Opcional
Licence Número asignado como su código de licencia. Obligatorio
SEARCH_REF Referencia de búsqueda devuelta por el endpoint Lookup. Obligatorio
Country Código de país ISO de 3 letras. Obligatorio
extension Si se establece en all, devuelve la forma extendida (JSON completo). Opcional. Valor por defecto: 1
NAF25 Obtener o no el nuevo valor del Sic Code en Francia: True / False Opcional. Valor por defecto: False

Forma extendida

POST https://{SERVER_ADDRESS}/{VERSION}/infocnum/{CompanyNumber}/
Parámetro Descripción Obligatorio/Opcional
Licence Número asignado como su código de licencia. Obligatorio
CompanyNumber Número SIRET de la empresa. Obligatorio
Country Código de país ISO de 3 letras. Obligatorio
NAF25 Obtener o no el nuevo valor del Sic Code en Francia: True / False Opcional. Valor por defecto: False

Respuesta

Éxito

Forma comprimida

La respuesta JSON es un objeto que contiene dos claves principales:

  • Found: número de empresas encontradas.
  • Companies: lista que contiene uno o más objetos de empresa.

Cada objeto de empresa contiene las siguientes claves:

Clave Descripción Tipo / Restricciones
L1Standardized Línea 1 de dirección estandarizada, a menudo la razón social. Cadena, hasta 255 caracteres
MainCompanyFlag Indica si este es el registro principal de la empresa. 1: sí; 0: no. Cadena o entero
CompanyStatus Estado administrativo de la empresa. Cadena o entero
Country Código de país ISO 3166-1 alfa-3. Cadena, 3 caracteres
VatNumber Número de IVA intracomunitario.
Este campo está vacío si la empresa no está sujeta a IVA.
Cadena
City Ciudad donde se encuentra la empresa. Cadena, hasta 100 caracteres
SearchRef Referencia interna que vincula el resultado con la solicitud de búsqueda. Cadena
PhoneNumber Número de teléfono de la empresa. Cadena
LegalStructure Forma jurídica de la empresa. Array de objetos: { Value, Label }
L2Standardized Línea 2 de dirección estandarizada. Cadena
Email Dirección de correo electrónico de la empresa. Cadena
CompanyNumber Identificadores legales, como SIREN y NIC. Array de objetos: { Type, Value }
CompanyCName Nombre comercial o nombre alternativo de la empresa. Cadena
Fax Número de fax de la empresa. Cadena
IncorporationDate Fecha de creación de la empresa. Cadena, YYYY-MM-DD
StaffCount Número o rango de empleados. Cadena
L5Standardized Línea 5 de dirección estandarizada. Cadena
DissolutionDate Fecha de disolución de la empresa, si aplica. Cadena, YYYY-MM-DD
Classification Códigos de clasificación de actividad, como NAF. Array de objetos: { Type, Value, Label }
L4Standardized Dirección postal estandarizada. Cadena
CompanyName2 Nombre secundario de la empresa. Cadena
TurnOver Facturación declarada. Cadena o número
PosCod Código postal. Cadena, hasta 10 caracteres

Ejemplo:

{
  "Found": 1,
  "Companies": [
    {
      "L1Standardized": "LAPIED CARRELAGE",
      "MainCompanyFlag": "1",
      "CompanyStatus": "1",
      "Country": "FRA",
      "VatNumber": "FR 62 402284269",
      "City": "MONETEAU",
      "SearchRef": "_24663079",
      "PhoneNumber": "",
      "LegalStructure": [{"Value": "5499", "Label": "Société à responsabilité limitée (sans autre indication)"}],
      "L2Standardized": "",
      "Email": "",
      "CompanyNumber": [{"Type": "Siren", "Value": "402284269"}, {"Type": "Nic", "Value": "00022"}],
      "CompanyCName": "",
      "Fax": "",
      "IncorporationDate": "2000-09-15",
      "StaffCount": "3-5",
      "L5Standardized": "",
      "DissolutionDate": "",
      "Classification": [{"Type": "NAF08", "Value": "4333Z", "Label": ""}],
      "L4Standardized": "4 RUE DES CAILLOTTES",
      "CompanyName2": "",
      "TurnOver": "",
      "PosCod": "89470"
    }
  ]
}

Forma extendida

La respuesta JSON es un objeto que contiene dos claves principales:

  • Found: número de empresas encontradas.
  • Companies: lista que contiene uno o más objetos de empresa.

Cada objeto de empresa contiene las siguientes claves:

Clave Descripción Tipo / Restricciones
Title Título asociado al registro de la empresa. Cadena
ClassificationEnt Códigos de clasificación de actividad a nivel de empresa. Array de objetos: { Type, Value, Label }
Department Código de departamento francés. Cadena
SocialSolidarityEconomy Indicador de clasificación de economía social y solidaria. Cadena
ActivityType Tipo de actividad. Cadena
RangeCodeStaffCountEnt Código de rango de plantilla de la empresa. Cadena
PhoneNumber Número de teléfono de la empresa. Cadena
CompanyNumber Identificadores legales, como SIREN y NIC. Array de objetos: { Type, Value }
CityId Identificador interno de la ciudad. Cadena
NatureCode Código que representa la naturaleza de la empresa. Cadena
StreetName Nombre de la calle sin número. Cadena
District Distrito o arrondissement. Cadena
FourthActivityEnt Cuarta actividad declarada de la empresa. Cadena
State Etiqueta de región o estado. Cadena
NatureLastUpdate Indicador del tipo de actualización de naturaleza. Cadena
Acronym Acrónimo de la empresa. Cadena
ThirdActivityEnt Tercera actividad declarada de la empresa. Cadena
DistributionDate Fecha de distribución o publicación. Cadena
EntYearValidity Año de validez de los cambios de datos de la empresa. Cadena
L1Standardized Línea 1 de dirección estandarizada. Cadena
StartDateActivities Fecha de inicio de las actividades. Cadena, YYYY-MM-DD
L2Registered Línea 2 de dirección registrada. Cadena
Distribution Indicador de distribución. Cadena
L3Standardized Línea 3 de dirección estandarizada. Cadena
Seasonality Indicador de estacionalidad. Cadena
EmployementArea Código de zona de empleo. Cadena
PosCod Código postal. Cadena
Category Categoría de tamaño de la empresa. Cadena
SecondActivityEnt Segunda actividad declarada de la empresa. Cadena
FirstName Nombre del representante. Cadena
IndPublipo Indicador de publicidad. Cadena
MainActivityMethodEnt Método utilizado para determinar la actividad principal. Cadena
L6Registered Línea 6 de dirección registrada. Cadena
L4Standardized Línea 4 de dirección estandarizada. Cadena
CharityNumber Identificador de entidad benéfica registrada, si aplica. Cadena
NatureLabel Etiqueta que describe la naturaleza de la empresa. Cadena
ProductiveEnt Indicador de empresa productiva. Cadena
Classification Códigos de clasificación de actividad. Array de objetos: { Type, Value, Label }
L4Registered Línea 4 de dirección registrada. Cadena
City Nombre de la ciudad. Cadena
StateCode Código administrativo de región o estado. Cadena
ActivityPlace Lugar donde se realiza la actividad principal. Cadena
SpecificProduction Indicador de producción específica. Cadena
RangeLabelStaffCount Etiqueta del rango de plantilla. Cadena
NicHeadquarter Identificador NIC de la sede central. Cadena
ClassificationYear Año asociado a la clasificación de actividad. Cadena
MainActivityMethod Método utilizado para definir la actividad principal. Cadena
TurnOver Facturación de la empresa. Cadena o número
IncorporationDateEnt Fecha de constitución de la empresa. Cadena, YYYY-MM-DD
StaffCountYearEnt Año de referencia para la plantilla de la empresa. Cadena
UrbanUnitNumber Código de unidad urbana. Cadena
StaffCountYear Año de medición de la plantilla. Cadena
L7Standardized Línea 7 de dirección estandarizada. Cadena
StaffCountEnt Plantilla de la empresa. Cadena
StoreType Clasificación del tipo de establecimiento. Cadena
IncorporationDate Fecha de constitución de la empresa. Cadena, YYYY-MM-DD
RangeLabelStaffCountEnt Etiqueta del rango de plantilla de la empresa. Cadena
StreetNum Número de la calle. Cadena
RangeCodeStaffCount Código que representa el rango de plantilla. Cadena
L5Standardized Línea 5 de dirección estandarizada. Cadena
MainActivity Código de actividad principal. Cadena
AuxiliaryActivity Código de actividad auxiliar. Cadena
PoBox Número de apartado de correos. Cadena
StreetType Tipo de vía. Cadena
VatNumber Número de identificación de IVA. Cadena
Email Dirección de correo electrónico de la empresa. Cadena
StaffCount Plantilla. Cadena
L3Registered Línea 3 de dirección registrada. Cadena
L1Registered Línea 1 de dirección registrada. Cadena
UrbanUnitDpt Código departamental de la unidad urbana. Cadena
UrbanUnitRange Rango de la unidad urbana. Cadena
L6Standardized Línea 6 de dirección estandarizada. Cadena
Origine Origen del registro de la empresa. Cadena
CompNum Número de empresa adicional. Cadena
CompanyCName Nombre comercial de la empresa. Cadena
Headquarter Indica si el registro corresponde a la sede central. Cadena o entero
L2Standardized Línea 2 de dirección estandarizada. Cadena
Productive Indicador de establecimiento productivo. Cadena
LastName Apellido del representante. Cadena
NatureLastUpdate1 / NatureLastUpdate2 / NatureLastUpdate3 Indicadores adicionales del tipo de actualización. Cadena
DetailCityRange Código detallado del rango de ciudad. Cadena
MonoActivity Indica si la empresa tiene una única actividad. Cadena
L5Registered Línea 5 de dirección registrada. Cadena
StateCodeEnt Código de región o estado de la empresa. Cadena
County Código de condado. Cadena
L7Registered Línea 7 de dirección registrada. Cadena
ClassificationYearEnt Año de clasificación de la empresa. Cadena
LegalStructure Lista de estructura jurídica. Array de objetos: { Value, Label }
LongCompanyName Razón social completa. Cadena
SocialSolidarityEconomyDate Fecha de ingreso a la economía social y solidaria. Cadena
CityIdEn Identificador extendido de la ciudad. Cadena
PublicCompCoopIntercom Código de cooperación intercomunal. Cadena
FirstActivityEnt Primera actividad declarada de la empresa. Cadena
LastUpdate Fecha de la última actualización de datos. Cadena
MainActivityEnt Código de actividad principal de la empresa. Cadena
DistributionDateEnt Fecha de distribución de los datos a nivel de empresa. Cadena

Ejemplo:

{
  "Found": 1,
  "Companies": [
    {
      "Title": "",
      "ClassificationEnt": [{"Type": "NAF08", "Value": "4333Z", "Label": "Travaux de revêtement des sols et des murs"}],
      "Department": "89",
      "SocialSolidarityEconomy": "",
      "ActivityType": "",
      "RangeCodeStaffCountEnt": "02",
      "PhoneNumber": "",
      "CompanyNumber": [{"Type": "Siren", "Value": "402284269"}, {"Type": "Nic", "Value": "00022"}],
      "CityId": "263",
      "NatureCode": "",
      "StreetName": "DES CAILLOTTES",
      "District": "1",
      "FourthActivityEnt": "",
      "State": "BOURGOGNE FRANCHE COMTE",
      "NatureLastUpdate": "F",
      "Acronym": "",
      "ThirdActivityEnt": "",
      "DistributionDate": "",
      "EntYearValidity": "",
      "L1Standardized": "LAPIED CARRELAGE",
      "StartDateActivities": "2000-09-15",
      "L2Registered": "",
      "Distribution": "O",
      "L3Standardized": "",
      "Seasonality": "",
      "EmployementArea": "2612",
      "PosCod": "89470",
      "Category": "PME",
      "SecondActivityEnt": "",
      "FirstName": "",
      "IndPublipo": "",
      "MainActivityMethodEnt": "",
      "L6Registered": "89470 MONETEAU",
      "L4Standardized": "4 RUE DES CAILLOTTES",
      "CharityNumber": "",
      "NatureLabel": "",
      "ProductiveEnt": "",
      "Classification": [{"Type": "NAF08", "Value": "4333Z", "Label": "Travaux de revêtement des sols et des murs"}],
      "L4Registered": "4 RUE DES CAILLOTTES",
      "City": "MONETEAU",
      "StateCode": "27",
      "ActivityPlace": "",
      "SpecificProduction": "",
      "RangeLabelStaffCount": "3-5",
      "NicHeadquarter": "00022",
      "ClassificationYear": "1995",
      "MainActivityMethod": "",
      "TurnOver": "",
      "IncorporationDateEnt": "1995-09-01",
      "StaffCountYearEnt": "2023",
      "UrbanUnitNumber": "02",
      "StaffCountYear": "2023",
      "L7Standardized": "FRA",
      "StaffCountEnt": "",
      "StoreType": "",
      "IncorporationDate": "2000-09-15",
      "RangeLabelStaffCountEnt": "3-5",
      "StreetNum": "4",
      "RangeCodeStaffCount": "02",
      "L5Standardized": "",
      "MainActivity": "4333ZZ",
      "AuxiliaryActivity": "",
      "PoBox": "",
      "StreetType": "RUE",
      "VatNumber": "FR 62 402284269",
      "Email": "",
      "StaffCount": "",
      "L3Registered": "",
      "L1Registered": "LAPIED CARRELAGE",
      "UrbanUnitDpt": "89",
      "UrbanUnitRange": "4",
      "L6Standardized": "89470 MONETEAU",
      "Origine": "",
      "CompNum": "",
      "CompanyCName": "",
      "Headquarter": "1",
      "L2Standardized": "",
      "Productive": "",
      "LastName": "",
      "NatureLastUpdate1": "",
      "NatureLastUpdate3": "",
      "NatureLastUpdate2": "",
      "DetailCityRange": "17",
      "MonoActivity": "",
      "L5Registered": "",
      "StateCodeEnt": "",
      "County": "02",
      "L7Registered": "FRA",
      "ClassificationYearEnt": "",
      "LegalStructure": [{"Value": "5499", "Label": "Société à responsabilité limitée (sans autre indication)"}],
      "LongCompanyName": "LAPIED CARRELAGE",
      "SocialSolidarityEconomyDate": "",
      "CityIdEn": "89263",
      "PublicCompCoopIntercom": "200067114",
      "FirstActivityEnt": "",
      "LastUpdate": "2025-01-22",
      "MainActivityEnt": "",
      "DistributionDateEnt": ""
    }
  ]
}

Error

Forma comprimida

Tipo de error Solicitud Tipo de respuesta
Falta el parámetro Licence https://{SERVER_ADDRESS}/{VERSION}/infosr/?SEARCH_REF=_24663079&Country=FRA {"status":400,"message":"Missing parameters","details":"Licence","error":"bad request"}
Parámetro Licence vacío https://{SERVER_ADDRESS}/{VERSION}/infosr/?SEARCH_REF=_24663079&Country=FRA&Licence= {"status":400,"message":"Missing parameters","details":"Licence","error":"bad request"}
Error en un parámetro https://{SERVER_ADDRESS}/{VERSION}/infosr/?SEARCH_REF=&Country=FRA&Licence={LICENSE} {"status":400,"message":"Missing parameters","details":"SEARCH_REF","error":"bad request"}

Forma extendida

Tipo de error Solicitud Tipo de respuesta
Falta el parámetro Licence https://{SERVER_ADDRESS}/{VERSION}/infocnum/40228426900022&Country=FRA {"status":400,"message":"Missing parameters","details":"Licence","error":"bad request"}
Parámetro Licence vacío https://{SERVER_ADDRESS}/{VERSION}/infocnum/40228426900022&Country=FRA&Licence= {"status":400,"message":"Missing parameters","details":"Licence","error":"bad request"}

Documentación Swagger

Ver también

Relacionada con

¿Fue útil este artículo?

Usuarios a los que les pareció útil: 0 de 0