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 |
| 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 |
| 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
- B2B API RESTful: Acceda a la documentación Swagger.
Ver también
Relacionada con