Búsqueda de empresas - API B2B Classic
Utilice este endpoint para buscar empresas y obtener una lista de resultados coincidentes. RECSIRET puede consultarse por nombre de empresa, por nombre de empresa y código postal, o por dirección postal.
Documentación relacionada de la API B2B Classic:
Búsqueda por nombre de empresa — RECSIRET
Busque empresas utilizando el nombre completo o parcial de la empresa.
Solo nombre de empresa
Solicitud
Se admiten tanto GET como POST.
{SERVER_ADDRESS} y {LICENCE_CODE} son proporcionados por DQE al crear la cuenta. Póngase en contacto con su gestor de cuenta DQE para obtenerlos.
GEThttps://{SERVER_ADDRESS}/RECSIRET/?CompanyName={COMPANY_NAME}&Dictionary=Y&Country={COUNTRY_CODE}&Licence={LICENCE_CODE}&Filter={FILTER}&NbMax={NB_MAX}
Ejemplos de código
Buscar "DECATHLON"
curl "https://{SERVER_ADDRESS}/RECSIRET/?CompanyName=DECATHLON&Dictionary=Y&Country=FRA&Licence={LICENCE_CODE}"
fetch("https://{SERVER_ADDRESS}/RECSIRET/?" + new URLSearchParams({
CompanyName: "DECATHLON",
Dictionary: "Y",
Country: "FRA",
Licence: "{LICENCE_CODE}"
}))
.then(r => r.json())
.then(data => console.log(data));
import requests
response = requests.get(
"https://{SERVER_ADDRESS}/RECSIRET/",
params={
"CompanyName": "DECATHLON",
"Dictionary": "Y",
"Country": "FRA",
"Licence": "{LICENCE_CODE}",
},
)
print(response.json())
<?php
$params = http_build_query([
'CompanyName' => 'DECATHLON',
'Dictionary' => 'Y',
'Country' => 'FRA',
'Licence' => '{LICENCE_CODE}',
]);
$ch = curl_init("https://{SERVER_ADDRESS}/RECSIRET/?{$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}/RECSIRET/', {
params: {
CompanyName: 'DECATHLON',
Dictionary: 'Y',
Country: 'FRA',
Licence: '{LICENCE_CODE}'
}
})
.then(response => console.log(response.data));
HttpClient client = HttpClient.newHttpClient();
String url = "https://{SERVER_ADDRESS}/RECSIRET/"
+ "?CompanyName=DECATHLON&Dictionary=Y&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}/RECSIRET/" +
"?CompanyName=DECATHLON&Dictionary=Y&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}/RECSIRET/" +
"?CompanyName=DECATHLON&Dictionary=Y&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}/RECSIRET/
Añada los siguientes parámetros en el cuerpo de la solicitud usando x-www-form-urlencoded.
Ejemplos de código
Buscar "DECATHLON"
curl -X POST "https://{SERVER_ADDRESS}/RECSIRET/" \
-H "Content-Type: application/x-www-form-urlencoded" \
-d "Licence={LICENCE_CODE}" \
-d "CompanyName=DECATHLON" \
-d "Country=FRA" \
-d "Dictionary=Y"
fetch("https://{SERVER_ADDRESS}/RECSIRET/", {
method: "POST",
headers: { "Content-Type": "application/x-www-form-urlencoded" },
body: new URLSearchParams({
Licence: "{LICENCE_CODE}",
CompanyName: "DECATHLON",
Country: "FRA",
Dictionary: "Y"
})
})
.then(r => r.json())
.then(data => console.log(data));
import requests
response = requests.post(
"https://{SERVER_ADDRESS}/RECSIRET/",
data={
"Licence": "{LICENCE_CODE}",
"CompanyName": "DECATHLON",
"Country": "FRA",
"Dictionary": "Y",
},
)
print(response.json())
<?php
$ch = curl_init("https://{SERVER_ADDRESS}/RECSIRET/");
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, http_build_query([
'Licence' => '{LICENCE_CODE}',
'CompanyName' => 'DECATHLON',
'Country' => 'FRA',
'Dictionary' => 'Y',
]));
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}/RECSIRET/', qs.stringify({
Licence: '{LICENCE_CODE}',
CompanyName: 'DECATHLON',
Country: 'FRA',
Dictionary: 'Y'
}))
.then(response => console.log(response.data));
HttpClient client = HttpClient.newHttpClient();
String form = "Licence={LICENCE_CODE}&CompanyName=DECATHLON&Country=FRA&Dictionary=Y";
HttpRequest request = HttpRequest.newBuilder()
.uri(URI.create("https://{SERVER_ADDRESS}/RECSIRET/"))
.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}",
["CompanyName"] = "DECATHLON",
["Country"] = "FRA",
["Dictionary"] = "Y"
};
var response = await client.PostAsync(
"https://{SERVER_ADDRESS}/RECSIRET/",
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("CompanyName", "DECATHLON")
form.Set("Country", "FRA")
form.Set("Dictionary", "Y")
resp, err := http.PostForm("https://{SERVER_ADDRESS}/RECSIRET/", form)
if err != nil {
panic(err)
}
defer resp.Body.Close()
body, _ := io.ReadAll(resp.Body)
fmt.Println(string(body))
}
Parámetros
| Parámetro | Valor | Descripción | Oblig. / Opc. |
|---|---|---|---|
| SERVER_ADDRESS | {SERVER_ADDRESS} |
Dirección del servidor DQE que procesará los datos. | Obligatorio |
| Licence | {LICENCE_CODE} |
Código de licencia asignado a su cuenta. | Obligatorio |
| CompanyName | {COMPANY_NAME} |
Nombre de la empresa o parte del nombre de la empresa. | Obligatorio |
| Country | {COUNTRY_CODE} |
Código de país ISO de 3 letras. | Obligatorio |
| Dictionary | Y |
Activa la búsqueda de empresas basada en diccionario. | Obligatorio |
| Filter | {FILTER} |
Filtro de estado de la empresa. Se pueden separar varios valores con comas. | Opcional. Valor por defecto: 1. |
| NbMax | {NB_MAX} |
Número máximo de resultados a devolver. | Opcional. Valor por defecto: 10. |
| NAF25 | {NAF25} |
Obtener o no el nuevo valor del código Sic en Francia: True / False | Opcional. Valor por defecto: False
|
Valores de Filter
| Valor | Descripción |
|---|---|
| 1 | Empresas difusibles abiertas. |
| 2 | Empresas difusibles cerradas. |
| 3 | Empresas difusibles cerradas desde hace más de 3 años. |
| 4 | Empresas no difusibles. |
| 5 | Registros RNA. |
Probar la API
Haga clic en el botón de abajo para probar este endpoint en vivo desde su navegador.
Abrir consola
Búsqueda por nombre de empresa y código postal — RECSIRET
Acote una búsqueda por nombre de empresa añadiendo también un código postal o de departamento.
Nombre de empresa y código postal
Solicitud
Se admiten tanto GET como POST.
{SERVER_ADDRESS} y {LICENCE_CODE} son proporcionados por DQE al crear la cuenta. Póngase en contacto con su gestor de cuenta DQE para obtenerlos.
GEThttps://{SERVER_ADDRESS}/RECSIRET/?ZIP_Code={POSTAL_CODE}&CompanyName={COMPANY_NAME}&Dictionary=Y&Country={COUNTRY_CODE}&Licence={LICENCE_CODE}&Filter={FILTER}&NbMax={NB_MAX}
Ejemplos de código
Buscar "DECATHLON" en el código postal 59650
curl "https://{SERVER_ADDRESS}/RECSIRET/?ZIP_Code=59650&CompanyName=DECATHLON&Dictionary=Y&Country=FRA&Licence={LICENCE_CODE}"
fetch("https://{SERVER_ADDRESS}/RECSIRET/?" + new URLSearchParams({
ZIP_Code: "59650",
CompanyName: "DECATHLON",
Dictionary: "Y",
Country: "FRA",
Licence: "{LICENCE_CODE}"
}))
.then(r => r.json())
.then(data => console.log(data));
import requests
response = requests.get(
"https://{SERVER_ADDRESS}/RECSIRET/",
params={
"ZIP_Code": "59650",
"CompanyName": "DECATHLON",
"Dictionary": "Y",
"Country": "FRA",
"Licence": "{LICENCE_CODE}",
},
)
print(response.json())
<?php
$params = http_build_query([
'ZIP_Code' => '59650',
'CompanyName' => 'DECATHLON',
'Dictionary' => 'Y',
'Country' => 'FRA',
'Licence' => '{LICENCE_CODE}',
]);
$ch = curl_init("https://{SERVER_ADDRESS}/RECSIRET/?{$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}/RECSIRET/', {
params: {
ZIP_Code: '59650',
CompanyName: 'DECATHLON',
Dictionary: 'Y',
Country: 'FRA',
Licence: '{LICENCE_CODE}'
}
})
.then(response => console.log(response.data));
HttpClient client = HttpClient.newHttpClient();
String url = "https://{SERVER_ADDRESS}/RECSIRET/"
+ "?ZIP_Code=59650&CompanyName=DECATHLON&Dictionary=Y&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}/RECSIRET/" +
"?ZIP_Code=59650&CompanyName=DECATHLON&Dictionary=Y&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}/RECSIRET/" +
"?ZIP_Code=59650&CompanyName=DECATHLON&Dictionary=Y&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}/RECSIRET/
Añada los siguientes parámetros en el cuerpo de la solicitud usando x-www-form-urlencoded.
Ejemplos de código
Buscar "DECATHLON" en el código postal 59650
curl -X POST "https://{SERVER_ADDRESS}/RECSIRET/" \
-H "Content-Type: application/x-www-form-urlencoded" \
-d "Licence={LICENCE_CODE}" \
-d "ZIP_Code=59650" \
-d "CompanyName=DECATHLON" \
-d "Country=FRA" \
-d "Dictionary=Y"
fetch("https://{SERVER_ADDRESS}/RECSIRET/", {
method: "POST",
headers: { "Content-Type": "application/x-www-form-urlencoded" },
body: new URLSearchParams({
Licence: "{LICENCE_CODE}",
ZIP_Code: "59650",
CompanyName: "DECATHLON",
Country: "FRA",
Dictionary: "Y"
})
})
.then(r => r.json())
.then(data => console.log(data));
import requests
response = requests.post(
"https://{SERVER_ADDRESS}/RECSIRET/",
data={
"Licence": "{LICENCE_CODE}",
"ZIP_Code": "59650",
"CompanyName": "DECATHLON",
"Country": "FRA",
"Dictionary": "Y",
},
)
print(response.json())
<?php
$ch = curl_init("https://{SERVER_ADDRESS}/RECSIRET/");
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, http_build_query([
'Licence' => '{LICENCE_CODE}',
'ZIP_Code' => '59650',
'CompanyName' => 'DECATHLON',
'Country' => 'FRA',
'Dictionary' => 'Y',
]));
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}/RECSIRET/', qs.stringify({
Licence: '{LICENCE_CODE}',
ZIP_Code: '59650',
CompanyName: 'DECATHLON',
Country: 'FRA',
Dictionary: 'Y'
}))
.then(response => console.log(response.data));
HttpClient client = HttpClient.newHttpClient();
String form = "Licence={LICENCE_CODE}&ZIP_Code=59650&CompanyName=DECATHLON&Country=FRA&Dictionary=Y";
HttpRequest request = HttpRequest.newBuilder()
.uri(URI.create("https://{SERVER_ADDRESS}/RECSIRET/"))
.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}",
["ZIP_Code"] = "59650",
["CompanyName"] = "DECATHLON",
["Country"] = "FRA",
["Dictionary"] = "Y"
};
var response = await client.PostAsync(
"https://{SERVER_ADDRESS}/RECSIRET/",
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("ZIP_Code", "59650")
form.Set("CompanyName", "DECATHLON")
form.Set("Country", "FRA")
form.Set("Dictionary", "Y")
resp, err := http.PostForm("https://{SERVER_ADDRESS}/RECSIRET/", form)
if err != nil {
panic(err)
}
defer resp.Body.Close()
body, _ := io.ReadAll(resp.Body)
fmt.Println(string(body))
}
Parámetros
| Parámetro | Valor | Descripción | Oblig. / Opc. |
|---|---|---|---|
| SERVER_ADDRESS | {SERVER_ADDRESS} |
Dirección del servidor DQE que procesará los datos. | Obligatorio |
| Licence | {LICENCE_CODE} |
Código de licencia asignado a su cuenta. | Obligatorio |
| ZIP_Code | {POSTAL_CODE} |
Código postal o código de departamento. | Obligatorio |
| CompanyName | {COMPANY_NAME} |
Nombre de la empresa. | Obligatorio |
| Country | {COUNTRY_CODE} |
Código de país ISO de 3 letras. | Obligatorio |
| Dictionary | Y |
Activa la búsqueda de empresas basada en diccionario. | Obligatorio |
| Filter | {FILTER} |
Filtro de estado de la empresa. Se pueden separar varios valores con comas. | Opcional. Valor por defecto: 1. |
| NbMax | {NB_MAX} |
Número máximo de resultados a devolver. | Opcional. Valor por defecto: 10. |
| NAF25 | {NAF25} |
Obtener o no el nuevo valor del código Sic en Francia: True / False | Opcional. Valor por defecto: False
|
Valores de Filter
| Valor | Descripción |
|---|---|
| 1 | Empresas difusibles abiertas. |
| 2 | Empresas difusibles cerradas. |
| 3 | Empresas difusibles cerradas desde hace más de 3 años. |
| 4 | Empresas no difusibles. |
| 5 | Registros RNA. |
Probar la API
Haga clic en el botón de abajo para probar este endpoint en vivo desde su navegador.
Abrir consola
Búsqueda por dirección postal — RECSIRET
Busque empresas utilizando una dirección, código postal y ciudad — sin necesidad de indicar el nombre de la empresa.
Solo dirección postal
Solicitud
Se admiten tanto GET como POST.
{SERVER_ADDRESS} y {LICENCE_CODE} son proporcionados por DQE al crear la cuenta. Póngase en contacto con su gestor de cuenta DQE para obtenerlos.
GEThttps://{SERVER_ADDRESS}/RECSIRET/?Address={ADDRESS}&PostalCode={POSTAL_CODE}&City={CITY}&Country={COUNTRY_CODE}&Dictionary=Y&Licence={LICENCE_CODE}&Filter={FILTER}&NbMax={NB_MAX}
Ejemplos de código
Buscar por dirección de la empresa
curl "https://{SERVER_ADDRESS}/RECSIRET/?Address=52%20ALLEE%20LAKANAL&PostalCode=59650&City=VILLENEUVE%20D%20ASCQ&Country=FRA&Dictionary=Y&Licence={LICENCE_CODE}"
fetch("https://{SERVER_ADDRESS}/RECSIRET/?" + new URLSearchParams({
Address: "52 ALLEE LAKANAL",
PostalCode: "59650",
City: "VILLENEUVE D ASCQ",
Country: "FRA",
Dictionary: "Y",
Licence: "{LICENCE_CODE}"
}))
.then(r => r.json())
.then(data => console.log(data));
import requests
response = requests.get(
"https://{SERVER_ADDRESS}/RECSIRET/",
params={
"Address": "52 ALLEE LAKANAL",
"PostalCode": "59650",
"City": "VILLENEUVE D ASCQ",
"Country": "FRA",
"Dictionary": "Y",
"Licence": "{LICENCE_CODE}",
},
)
print(response.json())
<?php
$params = http_build_query([
'Address' => '52 ALLEE LAKANAL',
'PostalCode' => '59650',
'City' => 'VILLENEUVE D ASCQ',
'Country' => 'FRA',
'Dictionary' => 'Y',
'Licence' => '{LICENCE_CODE}',
]);
$ch = curl_init("https://{SERVER_ADDRESS}/RECSIRET/?{$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}/RECSIRET/', {
params: {
Address: '52 ALLEE LAKANAL',
PostalCode: '59650',
City: 'VILLENEUVE D ASCQ',
Country: 'FRA',
Dictionary: 'Y',
Licence: '{LICENCE_CODE}'
}
})
.then(response => console.log(response.data));
HttpClient client = HttpClient.newHttpClient();
String url = "https://{SERVER_ADDRESS}/RECSIRET/"
+ "?Address=52%20ALLEE%20LAKANAL&PostalCode=59650&City=VILLENEUVE%20D%20ASCQ&Country=FRA&Dictionary=Y&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}/RECSIRET/" +
"?Address=52%20ALLEE%20LAKANAL&PostalCode=59650&City=VILLENEUVE%20D%20ASCQ&Country=FRA&Dictionary=Y&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}/RECSIRET/" +
"?Address=52%20ALLEE%20LAKANAL&PostalCode=59650&City=VILLENEUVE%20D%20ASCQ&Country=FRA&Dictionary=Y&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}/RECSIRET/
Añada los siguientes parámetros en el cuerpo de la solicitud usando x-www-form-urlencoded.
Ejemplos de código
Buscar por dirección de la empresa
curl -X POST "https://{SERVER_ADDRESS}/RECSIRET/" \
-H "Content-Type: application/x-www-form-urlencoded" \
-d "Licence={LICENCE_CODE}" \
-d "Address=52 ALLEE LAKANAL" \
-d "PostalCode=59650" \
-d "City=VILLENEUVE D ASCQ" \
-d "Country=FRA" \
-d "Dictionary=Y"
fetch("https://{SERVER_ADDRESS}/RECSIRET/", {
method: "POST",
headers: { "Content-Type": "application/x-www-form-urlencoded" },
body: new URLSearchParams({
Licence: "{LICENCE_CODE}",
Address: "52 ALLEE LAKANAL",
PostalCode: "59650",
City: "VILLENEUVE D ASCQ",
Country: "FRA",
Dictionary: "Y"
})
})
.then(r => r.json())
.then(data => console.log(data));
import requests
response = requests.post(
"https://{SERVER_ADDRESS}/RECSIRET/",
data={
"Licence": "{LICENCE_CODE}",
"Address": "52 ALLEE LAKANAL",
"PostalCode": "59650",
"City": "VILLENEUVE D ASCQ",
"Country": "FRA",
"Dictionary": "Y",
},
)
print(response.json())
<?php
$ch = curl_init("https://{SERVER_ADDRESS}/RECSIRET/");
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, http_build_query([
'Licence' => '{LICENCE_CODE}',
'Address' => '52 ALLEE LAKANAL',
'PostalCode' => '59650',
'City' => 'VILLENEUVE D ASCQ',
'Country' => 'FRA',
'Dictionary' => 'Y',
]));
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}/RECSIRET/', qs.stringify({
Licence: '{LICENCE_CODE}',
Address: '52 ALLEE LAKANAL',
PostalCode: '59650',
City: 'VILLENEUVE D ASCQ',
Country: 'FRA',
Dictionary: 'Y'
}))
.then(response => console.log(response.data));
HttpClient client = HttpClient.newHttpClient();
String form = "Licence={LICENCE_CODE}&Address=52%20ALLEE%20LAKANAL&PostalCode=59650&City=VILLENEUVE%20D%20ASCQ&Country=FRA&Dictionary=Y";
HttpRequest request = HttpRequest.newBuilder()
.uri(URI.create("https://{SERVER_ADDRESS}/RECSIRET/"))
.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}",
["Address"] = "52 ALLEE LAKANAL",
["PostalCode"] = "59650",
["City"] = "VILLENEUVE D ASCQ",
["Country"] = "FRA",
["Dictionary"] = "Y"
};
var response = await client.PostAsync(
"https://{SERVER_ADDRESS}/RECSIRET/",
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("Address", "52 ALLEE LAKANAL")
form.Set("PostalCode", "59650")
form.Set("City", "VILLENEUVE D ASCQ")
form.Set("Country", "FRA")
form.Set("Dictionary", "Y")
resp, err := http.PostForm("https://{SERVER_ADDRESS}/RECSIRET/", form)
if err != nil {
panic(err)
}
defer resp.Body.Close()
body, _ := io.ReadAll(resp.Body)
fmt.Println(string(body))
}
Parámetros
| Parámetro | Valor | Descripción | Oblig. / Opc. |
|---|---|---|---|
| SERVER_ADDRESS | {SERVER_ADDRESS} |
Dirección del servidor DQE que procesará los datos. | Obligatorio |
| Licence | {LICENCE_CODE} |
Código de licencia asignado a su cuenta. | Obligatorio |
| Address | {ADDRESS} |
Tipo de vía y nombre de la vía de la dirección de la empresa a verificar. | Obligatorio |
| PostalCode | {POSTAL_CODE} |
Código postal de la dirección de la empresa a verificar. | Obligatorio |
| City | {CITY} |
Nombre de la ciudad de la dirección de la empresa a verificar. | Obligatorio |
| Country | {COUNTRY_CODE} |
Código de país ISO de 3 letras. | Obligatorio |
| Dictionary | Y |
Activa la búsqueda de empresas basada en diccionario. | Obligatorio |
| Filter | {FILTER} |
Filtro de estado de la empresa. Se pueden separar varios valores con comas. | Opcional. Valor por defecto: 1. |
| NbMax | {NB_MAX} |
Número máximo de resultados a devolver. | Opcional. Valor por defecto: 10. |
| NAF25 | {NAF25} |
Obtener o no el nuevo valor del código Sic en Francia: True / False | Opcional. Valor por defecto: False
|
Valores de Filter
| Valor | Descripción |
|---|---|
| 1 | Empresas difusibles abiertas. |
| 2 | Empresas difusibles cerradas. |
| 3 | Empresas difusibles cerradas desde hace más de 3 años. |
| 4 | Empresas no difusibles. |
| 5 | Registros RNA. |
Probar la API
Haga clic en el botón de abajo para probar este endpoint en vivo desde su navegador.
Abrir consola
Respuesta
La respuesta JSON es un diccionario cuyas claves son DATA1, DATA2, etc. Cada valor es un diccionario que contiene los datos de la empresa. Contiene la clave SEARCH_REF, necesaria para obtener los datos completos de la empresa a través de SIRETINFO. Esta respuesta se aplica a los tres modos de búsqueda anteriores.
| Clave | Value | Francia | Internacional |
|---|---|---|---|
| SEARCH_REF | Referencia de búsqueda, para usar como entrada en SIRETINFO. | STRING | STRING |
| CompanyCName | Nombre complementario de la empresa (o nombre comercial). | STRING(50) | STRING(255) |
| LegalStructureLabel | Forma jurídica de la empresa (etiqueta). | STRING(100) | STRING(100) |
| IncorporationDate | Fecha de instalación de la empresa en la ciudad actual. | STRING | STRING |
| MainCompanyFlag |
1: sede social; 0: otro establecimiento de la empresa. |
STRING(1) | STRING(1) |
| CompanyStatus |
1: empresa en activo; 0: empresa que ya no está en activo. |
STRING(1) | STRING(1) |
| CompanyName | Nombre de la empresa. | STRING(131) | STRING(255) |
| CompanyAddress2 | Dirección de la empresa. | STRING(38) | STRING(50) |
| CompanyAddress3 | Información adicional de la dirección. | STRING(38) | STRING(50) |
| CompanyAddress1 | Puede contener la segunda parte de CompanyName si el nombre es demasiado largo. | STRING(38) | STRING(50) |
| Locality | Ciudad de la empresa. | STRING(38) | STRING(50) |
| Phone | Ya no se utiliza. | ||
| DissolutionDate | Fecha en que la empresa cesó su actividad. | STRING | STRING |
| StaffCount | Número de empleados. Consulte los valores de StaffCount a continuación. | STRING | STRING |
| CompanySIC | Código NAF de la empresa. | STRING(5) | STRING |
| LegalStructureCode | Forma jurídica de la empresa (código). | STRING(4) | STRING(4) |
| IntraNumber | Número de IVA intracomunitario. Este campo está vacío si la empresa no está sujeta a IVA. |
STRING(15) | STRING |
| ZIP_Code | Código postal de la ciudad de la empresa. | STRING(5) | STRING(10) |
| TurnOver | Ya no se utiliza. | ||
| CompanyNumber | Número SIRET de la empresa. | STRING(14) | STRING(14) |
| Country | Código de país ISO de 3 letras. | STRING(3) | STRING(3) |
Valores de StaffCount:
| Valor de StaffCount |
|---|
| No declarado |
| Sin asalariados |
| 0 |
| 1-2 |
| 3-5 |
| 6-9 |
| 10-19 |
| 20-49 |
| 50-99 |
| 100-199 |
| 200-249 |
| 250-499 |
| 500-999 |
| 1000-1999 |
| 2000-4999 |
| 5000-9999 |
| 10000+ |
Ejemplo de respuesta
Ejemplo de respuesta — DECATHLON
{
"DATA1": {
"SEARCH_REF": "_13367292",
"CompanyCName": "",
"IncorporationDate": "2024-06-24",
"LegalStructureLabel": "Société européenne",
"CompanyStatus": "1",
"CompanyName": "DECATHLON",
"CompanyAddress1": "",
"CompanyAddress2": "52 ALLEE LAKANAL",
"CompanyAddress3": "",
"Locality": "VILLENEUVE D ASCQ",
"DissolutionDate": "",
"Phone": "",
"MainCompanyFlag": "0",
"StaffCount": "Non-employer",
"CompanySIC": "8559A",
"LegalStructureCode": "5800",
"IntraNumber": "FR 51 306138900",
"ZIP_Code": "59650",
"TurnOver": "",
"CompanyNumber": "306xxxxxxxxxxx",
"Country": "FRA"
}
}
Errores
Solo nombre de empresa
| Tipo de error | Solicitud de ejemplo | Respuesta |
|---|---|---|
Falta el parámetro Licence
|
https://{SERVER_ADDRESS}/RECSIRET/?CompanyName={COMPANY_NAME}&Dictionary=Y&Country=FRA |
400 Bad Request Error |
Parámetro Licence vacío |
https://{SERVER_ADDRESS}/RECSIRET/?CompanyName={COMPANY_NAME}&Dictionary=Y&Country=FRA&Licence= |
400 Bad Request Error |
Parámetro CompanyName ausente o vacío |
https://{SERVER_ADDRESS}/RECSIRET/?Dictionary=Y&Country=FRA&Licence={LICENCE_CODE}https://{SERVER_ADDRESS}/RECSIRET/?CompanyName=&Dictionary=Y&Country=FRA&Licence={LICENCE_CODE}
|
{
"DATA1": {
"SEARCH_REF": "",
"CompanyCName": "",
"IncorporationDate": "",
"MainCompanyFlag": "",
"CompanyStatus": "",
"CompanyName": "",
"CompanyAddress2": "",
"CompanyAddress3": "",
"CompanyNumber": "",
"CompanyAddress1": "",
"Locality": "",
"Phone": "",
"DissolutionDate": "",
"CompanySIC": "",
"LegalStructureCode": "",
"IntraNumber": "",
"LegalStructureLabel": "",
"TurnOver": "",
"ZIP_Code": "",
"StaffCount": ""
}
} |
| Error en un parámetro | https://{SERVER_ADDRESS}/RECSIRET/?Companyame={COMPANY_NAME}&Dictionary=Y&Country=FRA&Licence={LICENCE_CODE} |
Misma respuesta vacía que la anterior |
Nombre de empresa y código postal
| Tipo de error | Solicitud de ejemplo | Respuesta |
|---|---|---|
Falta el parámetro Licence
|
https://{SERVER_ADDRESS}/RECSIRET/?ZIP_Code={POSTAL_CODE}&CompanyName={COMPANY_NAME}&Dictionary=Y&Country=FRA |
Respuesta vacía |
Parámetro Licence vacío |
https://{SERVER_ADDRESS}/RECSIRET/?ZIP_Code={POSTAL_CODE}&CompanyName={COMPANY_NAME}&Dictionary=Y&Country=FRA&Licence= |
Respuesta vacía |
Parámetro CompanyName ausente o vacío |
https://{SERVER_ADDRESS}/RECSIRET/?ZIP_Code={POSTAL_CODE}&Dictionary=Y&Country=FRA&Licence={LICENCE_CODE}https://{SERVER_ADDRESS}/RECSIRET/?ZIP_Code={POSTAL_CODE}&CompanyName=&Dictionary=Y&Country=FRA&Licence={LICENCE_CODE}
|
Misma respuesta vacía que la anterior |
Solo dirección postal
| Tipo de error | Solicitud de ejemplo | Respuesta |
|---|---|---|
Falta el parámetro Licence
|
https://{SERVER_ADDRESS}/RECSIRET/?Address={ADDRESS}&PostalCode={POSTAL_CODE}&City={CITY}&Dictionary=Y&Country=FRA |
400 Bad Request Error |
Parámetro Licence vacío |
https://{SERVER_ADDRESS}/RECSIRET/?Address={ADDRESS}&PostalCode={POSTAL_CODE}&City={CITY}&Dictionary=Y&Country=FRA&Licence= |
400 Bad Request Error |
| Error en un parámetro | https://{SERVER_ADDRESS}/RECSIRET/?Address={ADDRESS}&PostalCode={POSTAL_CODE}&City={CITY}&Dictionary=Y&Country=FRA&Licence={LICENCE_CODE} |
Misma respuesta vacía que la anterior |
Ver también
Relacionada con