B2B API — Buscar empresas
Utilice este endpoint para buscar empresas y obtener una lista de resultados coincidentes.
Documentación relacionada de la API B2B Restful:
Solo nombre de empresa
Busque empresas utilizando su razón social registrada.
lookupcname
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}/lookupcname/?CompanyName={INPUT}&Country={COUNTRY_CODE}&Licence={LICENCE_CODE}&Filter={FILTER}
Basta con sustituir los elementos entre llaves por su información.
Ejemplos de código
Buscar "dqe paris" en Francia
curl "https://{SERVER_ADDRESS}/{VERSION}/lookupcname/?CompanyName=dqe%20paris&Country=FRA&Licence={LICENCE_CODE}&Filter=1"
fetch("https://{SERVER_ADDRESS}/{VERSION}/lookupcname/?" + new URLSearchParams({
CompanyName: "dqe paris",
Country: "FRA",
Licence: "{LICENCE_CODE}",
Filter: "1"
}))
.then(r => r.json())
.then(data => console.log(data));
import requests
response = requests.get(
"https://{SERVER_ADDRESS}/{VERSION}/lookupcname/",
params={
"CompanyName": "dqe paris",
"Country": "FRA",
"Licence": "{LICENCE_CODE}",
"Filter": "1",
},
)
print(response.json())
<?php
$params = http_build_query([
'CompanyName' => 'dqe paris',
'Country' => 'FRA',
'Licence' => '{LICENCE_CODE}',
'Filter' => '1',
]);
$ch = curl_init("https://{SERVER_ADDRESS}/{VERSION}/lookupcname/?{$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}/lookupcname/', {
params: {
CompanyName: 'dqe paris',
Country: 'FRA',
Licence: '{LICENCE_CODE}',
Filter: '1'
}
})
.then(response => console.log(response.data));
HttpClient client = HttpClient.newHttpClient();
String url = "https://{SERVER_ADDRESS}/{VERSION}/lookupcname/"
+ "?CompanyName=dqe%20paris&Country=FRA&Licence={LICENCE_CODE}&Filter=1";
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}/lookupcname/" +
"?CompanyName=dqe%20paris&Country=FRA&Licence={LICENCE_CODE}&Filter=1";
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}/lookupcname/" +
"?CompanyName=dqe%20paris&Country=FRA&Licence={LICENCE_CODE}&Filter=1"
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}/lookupcname/
Añada los siguientes parámetros en el cuerpo de la solicitud usando x-www-form-urlencoded.
Ejemplos de código
Buscar "dqe paris" en Francia
curl -X POST "https://{SERVER_ADDRESS}/{VERSION}/lookupcname/" \
-H "Content-Type: application/x-www-form-urlencoded" \
-d "Licence={LICENCE_CODE}" \
-d "CompanyName=dqe paris" \
-d "Country=FRA" \
-d "Filter=1"
fetch("https://{SERVER_ADDRESS}/{VERSION}/lookupcname/", {
method: "POST",
headers: { "Content-Type": "application/x-www-form-urlencoded" },
body: new URLSearchParams({
Licence: "{LICENCE_CODE}",
CompanyName: "dqe paris",
Country: "FRA",
Filter: "1"
})
})
.then(r => r.json())
.then(data => console.log(data));
import requests
response = requests.post(
"https://{SERVER_ADDRESS}/{VERSION}/lookupcname/",
data={
"Licence": "{LICENCE_CODE}",
"CompanyName": "dqe paris",
"Country": "FRA",
"Filter": "1",
},
)
print(response.json())
<?php
$ch = curl_init("https://{SERVER_ADDRESS}/{VERSION}/lookupcname/");
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, http_build_query([
'Licence' => '{LICENCE_CODE}',
'CompanyName' => 'dqe paris',
'Country' => 'FRA',
'Filter' => '1',
]));
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}/lookupcname/', qs.stringify({
Licence: '{LICENCE_CODE}',
CompanyName: 'dqe paris',
Country: 'FRA',
Filter: '1'
}))
.then(response => console.log(response.data));
HttpClient client = HttpClient.newHttpClient();
String form = "Licence={LICENCE_CODE}&CompanyName=dqe%20paris&Country=FRA&Filter=1";
HttpRequest request = HttpRequest.newBuilder()
.uri(URI.create("https://{SERVER_ADDRESS}/{VERSION}/lookupcname/"))
.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"] = "dqe paris",
["Country"] = "FRA",
["Filter"] = "1"
};
var response = await client.PostAsync(
"https://{SERVER_ADDRESS}/{VERSION}/lookupcname/",
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", "dqe paris")
form.Set("Country", "FRA")
form.Set("Filter", "1")
resp, err := http.PostForm("https://{SERVER_ADDRESS}/{VERSION}/lookupcname/", 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 |
| CompanyName | Entrada del usuario: nombre de la empresa. | Mandatory |
| Country | Código de país ISO de 3 letras. | Mandatory |
| Filter | Filtro de estado de la empresa. Pueden separarse varios valores con comas. 1 — Difusible abierta 2 — Difusible cerrada 3 — Difusible cerrada antigua (+3 años) 4 — No difusible 5 — RNA Ejemplo: Filter=1,2Opcional. 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 |
Probar la API
Haga clic en el botón de abajo para probar este endpoint en vivo desde su navegador.
Abrir consola
Solo número de empresa
Busque empresas utilizando su número de empresa.
lookupcnum
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}/lookupcnum/?CompanyNumber={INPUT}&Country={COUNTRY_CODE}&Licence={LICENCE_CODE}&Filter={FILTER}
Basta con sustituir los elementos entre llaves por su información.
Ejemplos de código
Buscar por número de empresa en Francia
curl "https://{SERVER_ADDRESS}/{VERSION}/lookupcnum/?CompanyNumber=504xxxxxx&Country=FRA&Licence={LICENCE_CODE}&Filter=1"
fetch("https://{SERVER_ADDRESS}/{VERSION}/lookupcnum/?" + new URLSearchParams({
CompanyNumber: "504xxxxxx",
Country: "FRA",
Licence: "{LICENCE_CODE}",
Filter: "1"
}))
.then(r => r.json())
.then(data => console.log(data));
import requests
response = requests.get(
"https://{SERVER_ADDRESS}/{VERSION}/lookupcnum/",
params={
"CompanyNumber": "504xxxxxx",
"Country": "FRA",
"Licence": "{LICENCE_CODE}",
"Filter": "1",
},
)
print(response.json())
<?php
$params = http_build_query([
'CompanyNumber' => '504xxxxxx',
'Country' => 'FRA',
'Licence' => '{LICENCE_CODE}',
'Filter' => '1',
]);
$ch = curl_init("https://{SERVER_ADDRESS}/{VERSION}/lookupcnum/?{$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}/lookupcnum/', {
params: {
CompanyNumber: '504xxxxxx',
Country: 'FRA',
Licence: '{LICENCE_CODE}',
Filter: '1'
}
})
.then(response => console.log(response.data));
HttpClient client = HttpClient.newHttpClient();
String url = "https://{SERVER_ADDRESS}/{VERSION}/lookupcnum/"
+ "?CompanyNumber=504xxxxxx&Country=FRA&Licence={LICENCE_CODE}&Filter=1";
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}/lookupcnum/" +
"?CompanyNumber=504xxxxxx&Country=FRA&Licence={LICENCE_CODE}&Filter=1";
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}/lookupcnum/" +
"?CompanyNumber=504xxxxxx&Country=FRA&Licence={LICENCE_CODE}&Filter=1"
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}/lookupcnum/
Añada los siguientes parámetros en el cuerpo de la solicitud usando x-www-form-urlencoded.
Ejemplos de código
Buscar por número de empresa en Francia
curl -X POST "https://{SERVER_ADDRESS}/{VERSION}/lookupcnum/" \
-H "Content-Type: application/x-www-form-urlencoded" \
-d "Licence={LICENCE_CODE}" \
-d "CompanyNumber=504xxxxxx" \
-d "Country=FRA" \
-d "Filter=1"
fetch("https://{SERVER_ADDRESS}/{VERSION}/lookupcnum/", {
method: "POST",
headers: { "Content-Type": "application/x-www-form-urlencoded" },
body: new URLSearchParams({
Licence: "{LICENCE_CODE}",
CompanyNumber: "504xxxxxx",
Country: "FRA",
Filter: "1"
})
})
.then(r => r.json())
.then(data => console.log(data));
import requests
response = requests.post(
"https://{SERVER_ADDRESS}/{VERSION}/lookupcnum/",
data={
"Licence": "{LICENCE_CODE}",
"CompanyNumber": "504xxxxxx",
"Country": "FRA",
"Filter": "1",
},
)
print(response.json())
<?php
$ch = curl_init("https://{SERVER_ADDRESS}/{VERSION}/lookupcnum/");
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, http_build_query([
'Licence' => '{LICENCE_CODE}',
'CompanyNumber' => '504xxxxxx',
'Country' => 'FRA',
'Filter' => '1',
]));
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}/lookupcnum/', qs.stringify({
Licence: '{LICENCE_CODE}',
CompanyNumber: '504xxxxxx',
Country: 'FRA',
Filter: '1'
}))
.then(response => console.log(response.data));
HttpClient client = HttpClient.newHttpClient();
String form = "Licence={LICENCE_CODE}&CompanyNumber=504xxxxxx&Country=FRA&Filter=1";
HttpRequest request = HttpRequest.newBuilder()
.uri(URI.create("https://{SERVER_ADDRESS}/{VERSION}/lookupcnum/"))
.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"] = "504xxxxxx",
["Country"] = "FRA",
["Filter"] = "1"
};
var response = await client.PostAsync(
"https://{SERVER_ADDRESS}/{VERSION}/lookupcnum/",
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", "504xxxxxx")
form.Set("Country", "FRA")
form.Set("Filter", "1")
resp, err := http.PostForm("https://{SERVER_ADDRESS}/{VERSION}/lookupcnum/", 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 | Entrada del usuario: número de empresa. | Mandatory |
| Country | Código de país ISO de 3 letras. | Mandatory |
| Filter | Filtro de estado de la empresa. Pueden separarse varios valores con comas. 1 — Difusible abierta 2 — Difusible cerrada 3 — Difusible cerrada antigua (+3 años) 4 — No difusible 5 — RNA Ejemplo: Filter=1,2Opcional. 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 |
Probar la API
Haga clic en el botón de abajo para probar este endpoint en vivo desde su navegador.
Abrir consola
Nombre de empresa y código postal
Busque empresas utilizando su nombre junto con un código postal, para una coincidencia más precisa.
checkcname
Solicitud
Se admiten tanto GET como POST.
{SERVER_ADDRESS} y {LICENCE_CODE} los proporciona DQE al crear la cuenta. Póngase en contacto con su gestor de cuenta DQE para obtenerlos.
Específico de la versión: esta operación solo está disponible en la versión
v1 de la API — no está disponible en v2. Utilice v1 en la URL para esta operación en concreto, aunque el resto de operaciones B2B Restful admiten ambas versiones. GEThttps://{SERVER_ADDRESS}/v1/checkcname/?CompanyName={INPUT}&Country={COUNTRY_CODE}&PostalCode={POSTALCODE}&Licence={LICENCE_CODE}&Filter={FILTER}
Basta con sustituir los elementos entre llaves por su información.
Ejemplos de código
Buscar "dqe paris" cerca del código postal 75017
curl "https://{SERVER_ADDRESS}/v1/checkcname/?CompanyName=dqe%20paris&Country=FRA&PostalCode=75017&Licence={LICENCE_CODE}&Filter=1"
fetch("https://{SERVER_ADDRESS}/v1/checkcname/?" + new URLSearchParams({
CompanyName: "dqe paris",
Country: "FRA",
PostalCode: "75017",
Licence: "{LICENCE_CODE}",
Filter: "1"
}))
.then(r => r.json())
.then(data => console.log(data));
import requests
response = requests.get(
"https://{SERVER_ADDRESS}/v1/checkcname/",
params={
"CompanyName": "dqe paris",
"Country": "FRA",
"PostalCode": "75017",
"Licence": "{LICENCE_CODE}",
"Filter": "1",
},
)
print(response.json())
<?php
$params = http_build_query([
'CompanyName' => 'dqe paris',
'Country' => 'FRA',
'PostalCode' => '75017',
'Licence' => '{LICENCE_CODE}',
'Filter' => '1',
]);
$ch = curl_init("https://{SERVER_ADDRESS}/v1/checkcname/?{$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}/v1/checkcname/', {
params: {
CompanyName: 'dqe paris',
Country: 'FRA',
PostalCode: '75017',
Licence: '{LICENCE_CODE}',
Filter: '1'
}
})
.then(response => console.log(response.data));
HttpClient client = HttpClient.newHttpClient();
String url = "https://{SERVER_ADDRESS}/v1/checkcname/"
+ "?CompanyName=dqe%20paris&Country=FRA&PostalCode=75017&Licence={LICENCE_CODE}&Filter=1";
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}/v1/checkcname/" +
"?CompanyName=dqe%20paris&Country=FRA&PostalCode=75017&Licence={LICENCE_CODE}&Filter=1";
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}/v1/checkcname/" +
"?CompanyName=dqe%20paris&Country=FRA&PostalCode=75017&Licence={LICENCE_CODE}&Filter=1"
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}/v1/checkcname/
Añada los siguientes parámetros en el cuerpo de la solicitud usando x-www-form-urlencoded.
Ejemplos de código
Buscar "dqe paris" cerca del código postal 75017
curl -X POST "https://{SERVER_ADDRESS}/v1/checkcname/" \
-H "Content-Type: application/x-www-form-urlencoded" \
-d "Licence={LICENCE_CODE}" \
-d "CompanyName=dqe paris" \
-d "PostalCode=75017" \
-d "Country=FRA" \
-d "Filter=1"
fetch("https://{SERVER_ADDRESS}/v1/checkcname/", {
method: "POST",
headers: { "Content-Type": "application/x-www-form-urlencoded" },
body: new URLSearchParams({
Licence: "{LICENCE_CODE}",
CompanyName: "dqe paris",
PostalCode: "75017",
Country: "FRA",
Filter: "1"
})
})
.then(r => r.json())
.then(data => console.log(data));
import requests
response = requests.post(
"https://{SERVER_ADDRESS}/v1/checkcname/",
data={
"Licence": "{LICENCE_CODE}",
"CompanyName": "dqe paris",
"PostalCode": "75017",
"Country": "FRA",
"Filter": "1",
},
)
print(response.json())
<?php
$ch = curl_init("https://{SERVER_ADDRESS}/v1/checkcname/");
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, http_build_query([
'Licence' => '{LICENCE_CODE}',
'CompanyName' => 'dqe paris',
'PostalCode' => '75017',
'Country' => 'FRA',
'Filter' => '1',
]));
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}/v1/checkcname/', qs.stringify({
Licence: '{LICENCE_CODE}',
CompanyName: 'dqe paris',
PostalCode: '75017',
Country: 'FRA',
Filter: '1'
}))
.then(response => console.log(response.data));
HttpClient client = HttpClient.newHttpClient();
String form = "Licence={LICENCE_CODE}&CompanyName=dqe%20paris&PostalCode=75017&Country=FRA&Filter=1";
HttpRequest request = HttpRequest.newBuilder()
.uri(URI.create("https://{SERVER_ADDRESS}/v1/checkcname/"))
.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"] = "dqe paris",
["PostalCode"] = "75017",
["Country"] = "FRA",
["Filter"] = "1"
};
var response = await client.PostAsync(
"https://{SERVER_ADDRESS}/v1/checkcname/",
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", "dqe paris")
form.Set("PostalCode", "75017")
form.Set("Country", "FRA")
form.Set("Filter", "1")
resp, err := http.PostForm("https://{SERVER_ADDRESS}/v1/checkcname/", 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 | Fijado en v1 para esta operación — no configurable, v2 no lo admite. |
Mandatory |
| Licence | Número asignado como su código de licencia. | Mandatory |
| CompanyName | Entrada del usuario: nombre de la empresa. | Mandatory |
| PostalCode | Código postal. | Mandatory |
| Country | Código de país ISO de 3 letras. | Mandatory |
| Filter | Filtro de estado de la empresa. Pueden separarse varios valores con comas. 1 — Difusible abierta 2 — Difusible cerrada 3 — Difusible cerrada antigua (+3 años) 4 — No difusible 5 — RNA Ejemplo: Filter=1,2Opcional. 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 |
Probar la API
Haga clic en el botón de abajo para probar este endpoint en vivo desde su navegador.
Abrir consola
Respuesta
Esta forma de respuesta es compartida por los tres modos de solicitud anteriores (lookupcname, lookupcnum y checkcname).
La respuesta JSON es un diccionario (objeto) que contiene dos claves principales:
- Found: entero que indica el 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 |
|---|---|---|
| City | Ciudad donde se encuentra la empresa. | String, up to 100 characters |
| 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. 0: activa. |
String or integer |
| VatNumber | Número de IVA intracomunitario. Este campo está vacío si la empresa no está sujeta a IVA. |
String |
| 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 |
| CompanyNumber | Conjunto de identificadores legales, como SIREN y NIC. | Array of objects: { Type, Value }
|
| CompanyCName | Nombre comercial o razón social completa. | String |
| IncorporationDate | Fecha de creación de la empresa. | String, YYYY-MM-DD
|
| StaffCount | Número o rango de empleados declarado. | String |
| Classification | Códigos de clasificación de la actividad empresarial. | Array of objects: { Type, Value, Label }
|
| L5Standardized | Línea de dirección estandarizada 5. | String |
| DissolutionDate | Fecha en que la empresa cesó su actividad, si procede. | String, YYYY-MM-DD
|
| L4Standardized | Línea de dirección estandarizada que contiene la calle y el número. | String |
| PosCod | Código postal. | String, up to 10 characters |
| TurnOver | Facturación o ingresos declarados. | String or number |
Ejemplo de respuesta
Ejemplo: "DQE SOFTWARE" en París
{
"Found": 1,
"Companies": [
{
"City": "PARIS",
"L1Standardized": "DQE-SOFTWARE",
"MainCompanyFlag": "0",
"CompanyStatus": "0",
"VatNumber": "FR 85 504403387",
"SearchRef": "_33170132",
"PhoneNumber": "",
"LegalStructure": [
{
"Value": "5710",
"Label": "SAS, société par actions simplifiée"
}
],
"L2Standardized": "",
"CompanyNumber": [
{
"Type": "Siren",
"Value": "504xxxxxx"
},
{
"Type": "Nic",
"Value": "xxxxx"
}
],
"CompanyCName": "DQE SOFTWARE",
"IncorporationDate": "2014-11-17",
"StaffCount": "Non-employer",
"Classification": [
{
"Type": "NAF08",
"Value": "5829C",
"Label": "Edition de logiciels applicatifs"
}
],
"L5Standardized": "",
"DissolutionDate": "2018-01-31",
"L4Standardized": "42 RUE FORTUNY",
"PosCod": "75017",
"TurnOver": ""
}
]
}
Errores
Estos errores se aplican a los tres modos de solicitud anteriores — la API clasifica los errores por el nombre del parámetro que falta o no es válido, no por endpoint.
| 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"} |
| 401 | Número de licencia incorrecto | {"status": 401, "message": "Your licence is not allowed to cover this functionnality", "details": "{WRONG LICENSE}", "error": "unauthorized_client"} |
| 400 | Falta el parámetro CompanyName (o CompanyNumber / PostalCode, según el modo utilizado) |
{"status": 400, "message": "Missing parameters", "details": "CompanyName", "error": "bad request"} |
| 400 | Falta el parámetro Country
|
{"status": 400, "message": "Missing parameters", "details": "Country", "error": "bad request"} |
| 400 | Parámetro CompanyName vacío |
{"status": 400, "message": "Missing parameters", "details": "CompanyName", "error": "bad request"} |
| 200 | Parámetro Country vacío — no se trata como un error, devuelve un resultado vacío |
{"Found":0,"Companies":[]} |
Ver también
Relacionada con