B2B API — Buscar empresas (Classic)

Support DQE
Support DQE
  • Actualización

Utilice este endpoint para buscar empresas y obtener una lista de resultados coincidentes.

Documentación relacionada de B2B Classic API:

Solicitud GET

El endpoint RECSIRET se puede consultar por nombre de empresa, nombre de empresa y código postal, o dirección postal.

Solo nombre de empresa

Endpoint

https://{SERVER_ADDRESS}/RECSIRET/?CompanyName={COMPANY_NAME}&Dictionary=Y&Country={COUNTRY_CODE}&Licence={LICENCE_CODE}&Filter={FILTER}&NbMax={NB_MAX}
Parámetro Valor Descripción Obligatorio/Opcional
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 Habilita la búsqueda de empresas basada en diccionario. Obligatorio
Filter {FILTER} Filtro de estado de la empresa. Se pueden indicar varios valores separados por 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 el nuevo valor del Sic Code en Francia o no: True / False Opcional. Valor por defecto: False

Nombre de empresa y código postal

Endpoint

https://{SERVER_ADDRESS}/RECSIRET/?ZIP_Code={POSTAL_CODE}&CompanyName={COMPANY_NAME}&Dictionary=Y&Country={COUNTRY_CODE}&Licence={LICENCE_CODE}&Filter={FILTER}&NbMax={NB_MAX}
Parámetro Valor Descripción Obligatorio/Opcional
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 Habilita la búsqueda de empresas basada en diccionario. Obligatorio
Filter {FILTER} Filtro de estado de la empresa. Se pueden indicar varios valores separados por 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 el nuevo valor del Sic Code en Francia o no: True / False Opcional. Valor por defecto: False

Solo dirección postal

Endpoint

https://{SERVER_ADDRESS}/RECSIRET/?Address={ADDRESS}&CP={POSTAL_CODE}&City={CITY}&Country={COUNTRY_CODE}&Dictionary=Y&Licence={LICENCE_CODE}&Filter={FILTER}&NbMax={NB_MAX}
Parámetro Valor Descripción Obligatorio/Opcional
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 calle de la dirección comercial a verificar. Obligatorio
CP {POSTAL_CODE} Código postal de la dirección comercial a verificar. Obligatorio
City {CITY} Nombre de la ciudad de la dirección comercial a verificar. Obligatorio
Country {COUNTRY_CODE} Código de país ISO de 3 letras. Obligatorio
Dictionary Y Habilita la búsqueda de empresas basada en diccionario. Obligatorio
Filter {FILTER} Filtro de estado de la empresa. Se pueden indicar varios valores separados por 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 el nuevo valor del Sic Code en Francia o no: True / False Opcional. Valor por defecto: False

Valores del filtro

Valor Descripción
1 Empresas difusibles abiertas.
2 Empresas difusibles cerradas.
3 Empresas difusibles cerradas hace más de 3 años.
4 Empresas no difusibles.
5 Registros RNA.

Solicitud POST

Endpoint

https://{SERVER_ADDRESS}/RECSIRET/

Añada los siguientes parámetros en el cuerpo de la solicitud utilizando x-www-form-urlencoded.

Solo nombre de empresa

Parámetro Valor Descripción Obligatorio/Opcional
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 Habilita la búsqueda de empresas basada en diccionario. Obligatorio
Filter {FILTER} Filtro de estado de la empresa. Se pueden indicar varios valores separados por 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 el nuevo valor del Sic Code en Francia o no: True / False Opcional. Valor por defecto: False

Nombre de empresa y código postal

Parámetro Valor Descripción Obligatorio/Opcional
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 Habilita la búsqueda de empresas basada en diccionario. Obligatorio
Filter {FILTER} Filtro de estado de la empresa. Se pueden indicar varios valores separados por 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 el nuevo valor del Sic Code en Francia o no: True / False Opcional. Valor por defecto: False

Solo dirección postal

Parámetro Valor Descripción Obligatorio/Opcional
Licence {LICENCE_CODE} Código de licencia asignado a su cuenta. Obligatorio
Address {ADDRESS} Tipo de vía y nombre de la calle de la dirección comercial a verificar. Obligatorio
CP {POSTAL_CODE} Código postal de la dirección comercial a verificar. Obligatorio
City {CITY} Nombre de la ciudad de la dirección comercial a verificar. Obligatorio
Country {COUNTRY_CODE} Código de país ISO de 3 letras. Obligatorio
Dictionary Y Habilita la búsqueda de empresas basada en diccionario. Obligatorio
Filter {FILTER} Filtro de estado de la empresa. Se pueden indicar varios valores separados por 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 el nuevo valor del Sic Code en Francia o no: True / False Opcional. Valor por defecto: False

Valores del filtro

Valor Descripción
1 Empresas difusibles abiertas.
2 Empresas difusibles cerradas.
3 Empresas difusibles cerradas hace más de 3 años.
4 Empresas no difusibles.
5 Registros RNA.

Respuesta

Éxito

La respuesta JSON es un diccionario cuyas claves son DATA1, DATA2, etc. Cada valor es un diccionario que contiene los datos de la empresa. Incluye la clave SEARCH_REF, necesaria para obtener los detalles completos de la empresa a través de SIRETINFO.

Clave Valor Francia Internacional
SEARCH_REF Referencia de búsqueda, a utilizar como entrada para 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 central; 0: otra oficina de la empresa. STRING(1) STRING(1)
CompanyStatus 1: empresa en actividad; 0: empresa que ya no está en actividad. 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 incluir 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 la 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
Not declared
Non-employer
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:

{
  "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"
  }
}

Error

Solo nombre de empresa

Tipo de error Solicitud Tipo de 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 Tipo de 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 Tipo de respuesta
Falta el parámetro Licence https://{SERVER_ADDRESS}/RECSIRET/?Address={ADDRESS}&CP={POSTAL_CODE}&City={CITY}&Dictionary=Y&Country=FRA 400 Bad Request Error
Parámetro Licence vacío https://{SERVER_ADDRESS}/RECSIRET/?Address={ADDRESS}&CP={POSTAL_CODE}&City={CITY}&Dictionary=Y&Country=FRA&Licence= 400 Bad Request Error
Error en un parámetro https://{SERVER_ADDRESS}/RECSIRET/?Address={ADDRESS}&CP={POSTAL_CODE}&City={CITY}&Dictionary=Y&Country=FRA&Licence={LICENCE_CODE} Misma respuesta vacía que la anterior

Documentación Swagger

Consulte también

Relacionada con

¿Fue útil este artículo?

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