B2B API — Obtener información de una empresa
Utilice este endpoint para obtener información legal y administrativa detallada sobre una empresa seleccionada.
Documentación relacionada de la API B2B Restful:
Formulario comprimido
Obtenga un registro de empresa más ligero utilizando la referencia de búsqueda devuelta por el endpoint Lookup.
infosr
Solicitud
Se admiten tanto GET como POST.
{SERVER_ADDRESS}, {VERSION} y {LICENCE_CODE} los proporciona DQE al crear la cuenta. Póngase en contacto con su gestor de cuenta DQE para obtenerlos.
GEThttps://{SERVER_ADDRESS}/{VERSION}/infosr/SEARCH_REF={SEARCHREF}/?&Country={COUNTRY_CODE}&Licence={LICENCE_CODE}&extension={EXTENSION}
Basta con sustituir los elementos entre llaves por su información.
Ejemplos de código
Obtener "LAPIED CARRELAGE" por referencia de búsqueda
curl "https://{SERVER_ADDRESS}/{VERSION}/infosr/?SEARCH_REF=_24663079&Country=FRA&Licence={LICENCE_CODE}"
fetch("https://{SERVER_ADDRESS}/{VERSION}/infosr/?" + new URLSearchParams({
SEARCH_REF: "_24663079",
Country: "FRA",
Licence: "{LICENCE_CODE}"
}))
.then(r => r.json())
.then(data => console.log(data));
import requests
response = requests.get(
"https://{SERVER_ADDRESS}/{VERSION}/infosr/",
params={
"SEARCH_REF": "_24663079",
"Country": "FRA",
"Licence": "{LICENCE_CODE}",
},
)
print(response.json())
<?php
$params = http_build_query([
'SEARCH_REF' => '_24663079',
'Country' => 'FRA',
'Licence' => '{LICENCE_CODE}',
]);
$ch = curl_init("https://{SERVER_ADDRESS}/{VERSION}/infosr/?{$params}");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);
curl_close($ch);
$data = json_decode($response, true);
const axios = require('axios');
axios.get('https://{SERVER_ADDRESS}/{VERSION}/infosr/', {
params: {
SEARCH_REF: '_24663079',
Country: 'FRA',
Licence: '{LICENCE_CODE}'
}
})
.then(response => console.log(response.data));
HttpClient client = HttpClient.newHttpClient();
String url = "https://{SERVER_ADDRESS}/{VERSION}/infosr/"
+ "?SEARCH_REF=_24663079&Country=FRA&Licence={LICENCE_CODE}";
HttpRequest request = HttpRequest.newBuilder()
.uri(URI.create(url))
.GET()
.build();
HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());
using var client = new HttpClient();
var url = "https://{SERVER_ADDRESS}/{VERSION}/infosr/" +
"?SEARCH_REF=_24663079&Country=FRA&Licence={LICENCE_CODE}";
var response = await client.GetAsync(url);
var body = await response.Content.ReadAsStringAsync();
Console.WriteLine(body);
package main
import (
"fmt"
"io"
"net/http"
)
func main() {
url := "https://{SERVER_ADDRESS}/{VERSION}/infosr/" +
"?SEARCH_REF=_24663079&Country=FRA&Licence={LICENCE_CODE}"
resp, err := http.Get(url)
if err != nil {
panic(err)
}
defer resp.Body.Close()
body, _ := io.ReadAll(resp.Body)
fmt.Println(string(body))
}
POSThttps://{SERVER_ADDRESS}/{VERSION}/infosr/{SEARCH_REF}/
Añada los siguientes parámetros en el cuerpo de la solicitud usando x-www-form-urlencoded.
Ejemplos de código
Obtener "LAPIED CARRELAGE" por referencia de búsqueda
curl -X POST "https://{SERVER_ADDRESS}/{VERSION}/infosr/" \
-H "Content-Type: application/x-www-form-urlencoded" \
-d "Licence={LICENCE_CODE}" \
-d "SEARCH_REF=_24663079" \
-d "Country=FRA"
fetch("https://{SERVER_ADDRESS}/{VERSION}/infosr/", {
method: "POST",
headers: { "Content-Type": "application/x-www-form-urlencoded" },
body: new URLSearchParams({
Licence: "{LICENCE_CODE}",
SEARCH_REF: "_24663079",
Country: "FRA"
})
})
.then(r => r.json())
.then(data => console.log(data));
import requests
response = requests.post(
"https://{SERVER_ADDRESS}/{VERSION}/infosr/",
data={
"Licence": "{LICENCE_CODE}",
"SEARCH_REF": "_24663079",
"Country": "FRA",
},
)
print(response.json())
<?php
$ch = curl_init("https://{SERVER_ADDRESS}/{VERSION}/infosr/");
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, http_build_query([
'Licence' => '{LICENCE_CODE}',
'SEARCH_REF' => '_24663079',
'Country' => 'FRA',
]));
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);
curl_close($ch);
$data = json_decode($response, true);
const axios = require('axios');
const qs = require('querystring');
axios.post('https://{SERVER_ADDRESS}/{VERSION}/infosr/', qs.stringify({
Licence: '{LICENCE_CODE}',
SEARCH_REF: '_24663079',
Country: 'FRA'
}))
.then(response => console.log(response.data));
HttpClient client = HttpClient.newHttpClient();
String form = "Licence={LICENCE_CODE}&SEARCH_REF=_24663079&Country=FRA";
HttpRequest request = HttpRequest.newBuilder()
.uri(URI.create("https://{SERVER_ADDRESS}/{VERSION}/infosr/"))
.header("Content-Type", "application/x-www-form-urlencoded")
.POST(HttpRequest.BodyPublishers.ofString(form))
.build();
HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());
using var client = new HttpClient();
var form = new Dictionary<string, string> {
["Licence"] = "{LICENCE_CODE}",
["SEARCH_REF"] = "_24663079",
["Country"] = "FRA"
};
var response = await client.PostAsync(
"https://{SERVER_ADDRESS}/{VERSION}/infosr/",
new FormUrlEncodedContent(form));
var body = await response.Content.ReadAsStringAsync();
Console.WriteLine(body);
package main
import (
"fmt"
"io"
"net/http"
"net/url"
)
func main() {
form := url.Values{}
form.Set("Licence", "{LICENCE_CODE}")
form.Set("SEARCH_REF", "_24663079")
form.Set("Country", "FRA")
resp, err := http.PostForm("https://{SERVER_ADDRESS}/{VERSION}/infosr/", form)
if err != nil {
panic(err)
}
defer resp.Body.Close()
body, _ := io.ReadAll(resp.Body)
fmt.Println(string(body))
}
Parámetros
| Parámetro | Descripción | Obl. / Opc. |
|---|---|---|
| SERVER_ADDRESS | Dirección del servidor DQE que procesará los datos. | Mandatory |
| VERSION | Versión de la API. Ejemplo: v1
|
Mandatory |
| Licence | Número asignado como su código de licencia. | Mandatory |
| SEARCH_REF | Referencia de búsqueda devuelta por el endpoint Lookup. | Mandatory |
| Country | Código de país ISO de 3 letras. | Mandatory |
| extension | Si se establece en all, devuelve el formulario extendido (JSON completo).Opcional. Valor por defecto:
1
|
Optional |
| NAF25 | Obtener o no el nuevo valor del código Sic en Francia: True / False Opcional. Valor por defecto:
False
|
Optional |
Respuesta
Por defecto (formulario comprimido), este endpoint devuelve un registro de empresa más ligero. Pase extension=all para recibir en su lugar el formulario extendido (véase la sección Formulario extendido más abajo).
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 de dirección estandarizada 1, a menudo la razón social. | String, up to 255 characters |
| MainCompanyFlag | Indica si es el registro principal de la empresa. 1: sí; 0: no. |
String or integer |
| CompanyStatus | Estado administrativo de la empresa. | String or integer |
| Country | Código de país ISO 3166-1 alfa-3. | String, 3 characters |
| VatNumber | Número de IVA intracomunitario. Este campo está vacío si la empresa no está sujeta a IVA. |
String |
| City | Ciudad donde se encuentra la empresa. | String, up to 100 characters |
| SearchRef | Referencia interna que vincula el resultado con la solicitud de búsqueda. | String |
| PhoneNumber | Número de teléfono de la empresa. | String |
| LegalStructure | Forma jurídica de la empresa. | Array of objects: { Value, Label }
|
| L2Standardized | Línea de dirección estandarizada 2. | String |
| Dirección de correo electrónico de la empresa. | String | |
| CompanyNumber | Identificadores legales, como SIREN y NIC. | Array of objects: { Type, Value }
|
| CompanyCName | Nombre comercial o denominación alternativa de la empresa. | String |
| Fax | Número de fax de la empresa. | String |
| IncorporationDate | Fecha de creación de la empresa. | String, YYYY-MM-DD
|
| StaffCount | Número o rango de empleados. | String |
| L5Standardized | Línea de dirección estandarizada 5. | String |
| DissolutionDate | Fecha de disolución de la empresa, si procede. | String, YYYY-MM-DD
|
| Classification | Códigos de clasificación de la actividad, como el NAF. | Array of objects: { Type, Value, Label }
|
| L4Standardized | Dirección de calle estandarizada. | String |
| CompanyName2 | Nombre comercial secundario. | String |
| TurnOver | Facturación declarada. | String or number |
| PosCod | Código postal. | String, up to 10 characters |
Ejemplo de respuesta
Ejemplo: "LAPIED CARRELAGE" (formulario comprimido)
{
"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"
}
]
}
Errores
| HTTP | Tipo de error | Cuerpo de la respuesta |
|---|---|---|
| 400 | Falta el parámetro Licence
|
{"status":400,"message":"Missing parameters","details":"Licence","error":"bad request"} |
| 400 | Parámetro Licence vacío |
{"status":400,"message":"Missing parameters","details":"Licence","error":"bad request"} |
| 400 | Error en un parámetro (p. ej. SEARCH_REF vacío) |
{"status":400,"message":"Missing parameters","details":"SEARCH_REF","error":"bad request"} |
Probar la API
Haga clic en el botón de abajo para probar este endpoint en vivo desde su navegador.
Abrir consola
Formulario extendido
Obtenga el registro completo y detallado de la empresa directamente a partir de un número de empresa (SIRET).
infocnum
Solicitud
Se admiten tanto GET como POST.
{SERVER_ADDRESS}, {VERSION} y {LICENCE_CODE} los proporciona DQE al crear la cuenta. Póngase en contacto con su gestor de cuenta DQE para obtenerlos.
GEThttps://{SERVER_ADDRESS}/{VERSION}/infocnum/CompanyNumber={INPUT}/?&Country={COUNTRY_CODE}&Licence={LICENCE_CODE}
Basta con sustituir los elementos entre llaves por su información.
Ejemplos de código
Obtener "LAPIED CARRELAGE" por número de empresa
curl "https://{SERVER_ADDRESS}/{VERSION}/infocnum/?CompanyNumber=40228426900022&Country=FRA&Licence={LICENCE_CODE}"
fetch("https://{SERVER_ADDRESS}/{VERSION}/infocnum/?" + new URLSearchParams({
CompanyNumber: "40228426900022",
Country: "FRA",
Licence: "{LICENCE_CODE}"
}))
.then(r => r.json())
.then(data => console.log(data));
import requests
response = requests.get(
"https://{SERVER_ADDRESS}/{VERSION}/infocnum/",
params={
"CompanyNumber": "40228426900022",
"Country": "FRA",
"Licence": "{LICENCE_CODE}",
},
)
print(response.json())
<?php
$params = http_build_query([
'CompanyNumber' => '40228426900022',
'Country' => 'FRA',
'Licence' => '{LICENCE_CODE}',
]);
$ch = curl_init("https://{SERVER_ADDRESS}/{VERSION}/infocnum/?{$params}");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);
curl_close($ch);
$data = json_decode($response, true);
const axios = require('axios');
axios.get('https://{SERVER_ADDRESS}/{VERSION}/infocnum/', {
params: {
CompanyNumber: '40228426900022',
Country: 'FRA',
Licence: '{LICENCE_CODE}'
}
})
.then(response => console.log(response.data));
HttpClient client = HttpClient.newHttpClient();
String url = "https://{SERVER_ADDRESS}/{VERSION}/infocnum/"
+ "?CompanyNumber=40228426900022&Country=FRA&Licence={LICENCE_CODE}";
HttpRequest request = HttpRequest.newBuilder()
.uri(URI.create(url))
.GET()
.build();
HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());
using var client = new HttpClient();
var url = "https://{SERVER_ADDRESS}/{VERSION}/infocnum/" +
"?CompanyNumber=40228426900022&Country=FRA&Licence={LICENCE_CODE}";
var response = await client.GetAsync(url);
var body = await response.Content.ReadAsStringAsync();
Console.WriteLine(body);
package main
import (
"fmt"
"io"
"net/http"
)
func main() {
url := "https://{SERVER_ADDRESS}/{VERSION}/infocnum/" +
"?CompanyNumber=40228426900022&Country=FRA&Licence={LICENCE_CODE}"
resp, err := http.Get(url)
if err != nil {
panic(err)
}
defer resp.Body.Close()
body, _ := io.ReadAll(resp.Body)
fmt.Println(string(body))
}
POSThttps://{SERVER_ADDRESS}/{VERSION}/infocnum/{CompanyNumber}/
Añada los siguientes parámetros en el cuerpo de la solicitud usando x-www-form-urlencoded.
Ejemplos de código
Obtener "LAPIED CARRELAGE" por número de empresa
curl -X POST "https://{SERVER_ADDRESS}/{VERSION}/infocnum/" \
-H "Content-Type: application/x-www-form-urlencoded" \
-d "Licence={LICENCE_CODE}" \
-d "CompanyNumber=40228426900022" \
-d "Country=FRA"
fetch("https://{SERVER_ADDRESS}/{VERSION}/infocnum/", {
method: "POST",
headers: { "Content-Type": "application/x-www-form-urlencoded" },
body: new URLSearchParams({
Licence: "{LICENCE_CODE}",
CompanyNumber: "40228426900022",
Country: "FRA"
})
})
.then(r => r.json())
.then(data => console.log(data));
import requests
response = requests.post(
"https://{SERVER_ADDRESS}/{VERSION}/infocnum/",
data={
"Licence": "{LICENCE_CODE}",
"CompanyNumber": "40228426900022",
"Country": "FRA",
},
)
print(response.json())
<?php
$ch = curl_init("https://{SERVER_ADDRESS}/{VERSION}/infocnum/");
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, http_build_query([
'Licence' => '{LICENCE_CODE}',
'CompanyNumber' => '40228426900022',
'Country' => 'FRA',
]));
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);
curl_close($ch);
$data = json_decode($response, true);
const axios = require('axios');
const qs = require('querystring');
axios.post('https://{SERVER_ADDRESS}/{VERSION}/infocnum/', qs.stringify({
Licence: '{LICENCE_CODE}',
CompanyNumber: '40228426900022',
Country: 'FRA'
}))
.then(response => console.log(response.data));
HttpClient client = HttpClient.newHttpClient();
String form = "Licence={LICENCE_CODE}&CompanyNumber=40228426900022&Country=FRA";
HttpRequest request = HttpRequest.newBuilder()
.uri(URI.create("https://{SERVER_ADDRESS}/{VERSION}/infocnum/"))
.header("Content-Type", "application/x-www-form-urlencoded")
.POST(HttpRequest.BodyPublishers.ofString(form))
.build();
HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());
using var client = new HttpClient();
var form = new Dictionary<string, string> {
["Licence"] = "{LICENCE_CODE}",
["CompanyNumber"] = "40228426900022",
["Country"] = "FRA"
};
var response = await client.PostAsync(
"https://{SERVER_ADDRESS}/{VERSION}/infocnum/",
new FormUrlEncodedContent(form));
var body = await response.Content.ReadAsStringAsync();
Console.WriteLine(body);
package main
import (
"fmt"
"io"
"net/http"
"net/url"
)
func main() {
form := url.Values{}
form.Set("Licence", "{LICENCE_CODE}")
form.Set("CompanyNumber", "40228426900022")
form.Set("Country", "FRA")
resp, err := http.PostForm("https://{SERVER_ADDRESS}/{VERSION}/infocnum/", form)
if err != nil {
panic(err)
}
defer resp.Body.Close()
body, _ := io.ReadAll(resp.Body)
fmt.Println(string(body))
}
Parámetros
| Parámetro | Descripción | Obl. / Opc. |
|---|---|---|
| SERVER_ADDRESS | Dirección del servidor DQE que procesará los datos. | Mandatory |
| VERSION | Versión de la API. Ejemplo: v1
|
Mandatory |
| Licence | Número asignado como su código de licencia. | Mandatory |
| CompanyNumber | Número SIRET de la empresa. | Mandatory |
| Country | Código de país ISO de 3 letras. | Mandatory |
| NAF25 | Obtener o no el nuevo valor del código Sic en Francia: True / False Opcional. Valor por defecto:
False
|
Optional |
Respuesta
Este endpoint siempre devuelve el registro completo (extendido) de la empresa.
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. | String |
| ClassificationEnt | Códigos de clasificación de actividad a nivel de empresa (enterprise). | Array of objects: { Type, Value, Label }
|
| Department | Código de departamento francés. | String |
| SocialSolidarityEconomy | Indicador de clasificación de economía social y solidaria. | String |
| ActivityType | Tipo de actividad. | String |
| RangeCodeStaffCountEnt | Código de rango de plantilla de la empresa (enterprise). | String |
| PhoneNumber | Número de teléfono de la empresa. | String |
| CompanyNumber | Identificadores legales, como SIREN y NIC. | Array of objects: { Type, Value }
|
| CityId | Identificador interno de la ciudad. | String |
| NatureCode | Código que representa la naturaleza de la empresa. | String |
| StreetName | Nombre de la calle sin número. | String |
| District | Distrito o arrondissement. | String |
| FourthActivityEnt | Cuarta actividad declarada de la empresa (enterprise). | String |
| State | Etiqueta de región o estado. | String |
| NatureLastUpdate | Indicador del tipo de actualización de naturaleza. | String |
| Acronym | Siglas de la empresa. | String |
| ThirdActivityEnt | Tercera actividad declarada de la empresa (enterprise). | String |
| DistributionDate | Fecha de distribución o publicación. | String |
| EntYearValidity | Año de validez de los cambios de datos de la empresa (enterprise). | String |
| L1Standardized | Línea de dirección estandarizada 1. | String |
| StartDateActivities | Fecha de inicio de la actividad. | String, YYYY-MM-DD
|
| L2Registered | Línea de dirección registrada 2. | String |
| Distribution | Indicador de distribución. | String |
| L3Standardized | Línea de dirección estandarizada 3. | String |
| Seasonality | Indicador de estacionalidad. | String |
| EmployementArea | Código de zona de empleo. | String |
| PosCod | Código postal. | String |
| Category | Categoría de tamaño de la empresa. | String |
| SecondActivityEnt | Segunda actividad declarada de la empresa (enterprise). | String |
| FirstName | Nombre de pila del representante. | String |
| IndPublipo | Indicador de publicidad directa. | String |
| MainActivityMethodEnt | Método utilizado para determinar la actividad principal. | String |
| L6Registered | Línea de dirección registrada 6. | String |
| L4Standardized | Línea de dirección estandarizada 4. | String |
| CharityNumber | Identificador de asociación/entidad registrada, si procede. | String |
| NatureLabel | Etiqueta que describe la naturaleza de la empresa. | String |
| ProductiveEnt | Indica si la empresa es productiva. | String |
| Classification | Códigos de clasificación de la actividad. | Array of objects: { Type, Value, Label }
|
| L4Registered | Línea de dirección registrada 4. | String |
| City | Nombre de la ciudad. | String |
| StateCode | Código administrativo de región o estado. | String |
| ActivityPlace | Lugar donde se ejerce la actividad principal. | String |
| SpecificProduction | Indicador de producción específica. | String |
| RangeLabelStaffCount | Etiqueta de rango de plantilla. | String |
| NicHeadquarter | Identificador NIC de la sede. | String |
| ClassificationYear | Año asociado a la clasificación de la actividad. | String |
| MainActivityMethod | Método utilizado para definir la actividad principal. | String |
| TurnOver | Facturación de la empresa. | String or number |
| IncorporationDateEnt | Fecha de constitución de la empresa (enterprise). | String, YYYY-MM-DD
|
| StaffCountYearEnt | Año de referencia de la plantilla de la empresa (enterprise). | String |
| UrbanUnitNumber | Código de unidad urbana. | String |
| StaffCountYear | Año de medición de la plantilla. | String |
| L7Standardized | Línea de dirección estandarizada 7. | String |
| StaffCountEnt | Plantilla de la empresa (enterprise). | String |
| StoreType | Clasificación del tipo de establecimiento. | String |
| IncorporationDate | Fecha de constitución de la empresa. | String, YYYY-MM-DD
|
| RangeLabelStaffCountEnt | Etiqueta de rango de plantilla de la empresa (enterprise). | String |
| StreetNum | Número de la calle. | String |
| RangeCodeStaffCount | Código que representa el rango de plantilla. | String |
| L5Standardized | Línea de dirección estandarizada 5. | String |
| MainActivity | Código de actividad principal. | String |
| AuxiliaryActivity | Código de actividad auxiliar. | String |
| PoBox | Número de apartado de correos. | String |
| StreetType | Tipo de vía. | String |
| VatNumber | Número de identificación del IVA. | String |
| Dirección de correo electrónico de la empresa. | String | |
| StaffCount | Plantilla. | String |
| L3Registered | Línea de dirección registrada 3. | String |
| L1Registered | Línea de dirección registrada 1. | String |
| UrbanUnitDpt | Código departamental de la unidad urbana. | String |
| UrbanUnitRange | Rango de la unidad urbana. | String |
| L6Standardized | Línea de dirección estandarizada 6. | String |
| Origine | Origen del registro de la empresa. | String |
| CompNum | Número de empresa adicional. | String |
| CompanyCName | Nombre comercial de la empresa. | String |
| Headquarter | Indica si el registro corresponde a la sede. | String or integer |
| L2Standardized | Línea de dirección estandarizada 2. | String |
| Productive | Indicador de establecimiento productivo. | String |
| LastName | Apellido del representante. | String |
| NatureLastUpdate1 / NatureLastUpdate2 / NatureLastUpdate3 | Indicadores adicionales del tipo de actualización. | String |
| DetailCityRange | Código detallado de rango de ciudad. | String |
| MonoActivity | Indica si la empresa tiene una única actividad. | String |
| L5Registered | Línea de dirección registrada 5. | String |
| StateCodeEnt | Código de región o estado de la empresa (enterprise). | String |
| County | Código de condado. | String |
| L7Registered | Línea de dirección registrada 7. | String |
| ClassificationYearEnt | Año de clasificación de la empresa (enterprise). | String |
| LegalStructure | Lista de formas jurídicas. | Array of objects: { Value, Label }
|
| LongCompanyName | Razón social oficial completa. | String |
| SocialSolidarityEconomyDate | Fecha de entrada en la economía social y solidaria. | String |
| CityIdEn | Identificador extendido de la ciudad. | String |
| PublicCompCoopIntercom | Código de cooperación intermunicipal. | String |
| FirstActivityEnt | Primera actividad declarada de la empresa (enterprise). | String |
| LastUpdate | Fecha de la última actualización de datos. | String |
| MainActivityEnt | Código de actividad principal de la empresa (enterprise). | String |
| DistributionDateEnt | Fecha de distribución de los datos a nivel de empresa (enterprise). | String |
Ejemplo de respuesta
Ejemplo: "LAPIED CARRELAGE" (formulario extendido)
{
"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": ""
}
]
}
Errores
| HTTP | Tipo de error | Cuerpo de la respuesta |
|---|---|---|
| 400 | Falta el parámetro Licence
|
{"status":400,"message":"Missing parameters","details":"Licence","error":"bad request"} |
| 400 | Parámetro Licence vacío |
{"status":400,"message":"Missing parameters","details":"Licence","error":"bad request"} |
Probar la API
Haga clic en el botón de abajo para probar este endpoint en vivo desde su navegador.
Abrir consola
Ver también
Relacionada con