Utilice este endpoint para obtener información jurídica detallada sobre una empresa seleccionada.
Documentación relacionada de la API B2B Classic:
Existen dos formas de obtener los datos de la empresa:
-
Forma comprimida: mediante el
SEARCH_REFdevuelto por RECSIRET. -
Forma extendida: directamente mediante el número
Siretde la empresa.
Obtenga los datos de la empresa utilizando el SEARCH_REF devuelto por una búsqueda RECSIRET previa.
Forma comprimida
Solicitud
Se admiten tanto GET como POST.
Ejemplos de código
Obtener DECATHLON mediante SEARCH_REF
Envíe los siguientes parámetros en el cuerpo de la solicitud usando x-www-form-urlencoded.
Ejemplos de código
Obtener DECATHLON mediante SEARCH_REF
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 |
| SEARCH_REF | {REF} |
Referencia de la empresa devuelta por la búsqueda RECSIRET. | Obligatorio |
| Dictionary | Y |
Activa la búsqueda basada en diccionario. | Obligatorio |
| Country | {COUNTRY_CODE} |
Código de país ISO de 3 letras. | Obligatorio |
| NAF25 | {NAF25} |
Obtener o no el nuevo valor del código Sic en Francia: True / False | Opcional. Valor por defecto: False
|
Respuesta
La respuesta JSON es un diccionario cuya clave es DATA1. Contiene los campos disponibles para la empresa seleccionada.
| Clave | Value | Francia | Internacional |
|---|---|---|---|
| SEARCH_REF | Referencia de búsqueda. | STRING | STRING |
| CompanyCName | Nombre complementario de la empresa o nombre comercial. | STRING(50) | STRING(255) |
| LegalStructureLabel | Forma jurídica de la empresa. | 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 | Información adicional de la dirección. | 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. | STRING | STRING |
| CompanySIC | Código NAF de la empresa. | STRING(5) | |
| LegalStructureCode | Código de forma jurídica de la empresa. | STRING(4) | STRING(4) |
| IntraNumber | Número de IVA intracomunitario. | 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) |
| CompanyName2 | Nombre corporativo adicional. | STRING | STRING |
| Activity1 | Código de forma jurídica. | STRING | STRING |
| Activity2 | Tamaño de la empresa, como PME, ME o GE. |
STRING(3) | STRING(3) |
| Ya no se utiliza. | |||
| Fax | Ya no se utiliza. | ||
| Country | Código de país ISO de 3 letras. | STRING(3) | STRING(3) |
Ejemplo de respuesta
Ejemplo de respuesta — DECATHLON (forma comprimida)
Errores
| Tipo de error | Solicitud de ejemplo | Respuesta |
|---|---|---|
Falta el parámetro Licence
|
https://{SERVER_ADDRESS}/SIRETINFO/?SEARCH_REF=_29613410&Dictionary=Y&Country=FRA |
400 Bad Request Error |
Parámetro Licence vacío |
https://{SERVER_ADDRESS}/SIRETINFO/?SEARCH_REF=_29613410&Dictionary=Y&Country=FRA&Licence= |
400 Bad Request Error |
| Error en un parámetro | https://{SERVER_ADDRESS}/SIRETINFO/?SEARCH_REF=_29613410&Dictionary=Y&Country=FRA&Licence={LICENCE_CODE} |
Respuesta vacía |
Probar la API
Haga clic en el botón de abajo para probar este endpoint en vivo desde su navegador.
Abrir consola
Retrieve full legal and establishment-level company details directly from a Siret number.
Forma extendida
Solicitud
Se admiten tanto GET como POST.
Ejemplos de código
Retrieve full details for SIRET 30613890003910
Envíe los siguientes parámetros en el cuerpo de la solicitud usando x-www-form-urlencoded.
Ejemplos de código
Retrieve full details for SIRET 30613890003910
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 |
| Siret | {SIRET} |
Número SIRET de la empresa. | Obligatorio |
| Country | {COUNTRY_CODE} |
Código de país ISO de 3 letras. | Obligatorio |
| NAF25 | {NAF25} |
Obtener o no el nuevo valor del código Sic en Francia: True / False | Opcional. Valor por defecto: False
|
Respuesta
La respuesta JSON es un diccionario que contiene los campos disponibles para la empresa seleccionada.
| Clave | Descripción | Francia |
|---|---|---|
| DQE_status |
FOUND o NOT FOUND. |
STRING(10) |
| SIREN | Identificador de la empresa. | STRING(9) |
| NIC | Número de clasificación interno del establecimiento. | STRING(5) |
| TVAINTRA | Número de IVA intracomunitario. Este campo está vacío si la empresa no está sujeta a IVA. |
STRING(25) |
| Dirección declarada normalizada | ||
| L1_NORMALISEE | Línea de dirección 1: nombre de la empresa, normalizado según el estándar AFNOR. | STRING(38) |
| L2_NORMALISEE | Línea de dirección 2: apartamento, puerta, escalera, normalizado según el estándar AFNOR. | STRING(38) |
| L3_NORMALISEE | Línea de dirección 3: edificio, normalizado según el estándar AFNOR. | STRING(38) |
| L4_NORMALISEE | Línea de dirección 4: calle y número, normalizado según el estándar AFNOR. | STRING(38) |
| L5_NORMALISEE | Línea de dirección 5: Cedex, apartado de correos, nombre del lugar, normalizado según el estándar AFNOR. | STRING(38) |
| L6_NORMALISEE | Línea de dirección 6: código postal y ciudad, normalizado según el estándar AFNOR. | STRING(38) |
| L7_NORMALISEE | Línea de dirección 7: país en código ISO3, normalizado según el estándar AFNOR. | STRING(38) |
| Dirección declarada | ||
| L1_DECLAREE | Dirección declarada del establecimiento. | STRING(38) |
| L2_DECLAREE | Dirección declarada del establecimiento. | STRING(38) |
| L3_DECLAREE | Dirección declarada del establecimiento. | STRING(38) |
| L4_DECLAREE | Dirección declarada del establecimiento. | STRING(38) |
| L5_DECLAREE | Dirección declarada del establecimiento. | STRING(38) |
| L6_DECLAREE | Dirección declarada del establecimiento. | STRING(38) |
| L7_DECLAREE | Dirección declarada del establecimiento. | STRING(38) |
| Dirección geográfica | ||
| NUMVOIE | Número de calle. | STRING(4) |
| INDREP | Información adicional del número de calle. | STRING(1) |
| TYPVOIE | Tipo de vía. | STRING(4) |
| LIBVOIE | Nombre de la vía. | STRING(32) |
| CODPOS | Código postal. | STRING(5) |
| CEDEX | Código CEDEX. | STRING(5) |
| Ubicación geográfica del establecimiento | ||
| RPET | Región. | STRING(2) |
| LIBREG | Etiqueta de región. | STRING(70) |
| DEPET | Departamento. | STRING(2) |
| ARRONET | Distrito. | STRING(2) |
| CTONET | Cantón. | STRING(3) |
| COMET | Ciudad. | STRING(3) |
| LIBCOM | Nombre de la ciudad. | STRING(32) |
| DU | Departamento de la unidad urbana. | STRING(2) |
| TU | Tamaño de la unidad urbana. | STRING(1) |
| UU | Número de unidad urbana. | STRING(2) |
| EPCI | Ubicación del establecimiento en un organismo público de cooperación intermunicipal. | STRING(9) |
| TCD | Área municipal detallada. | STRING(2) |
| ZEMET | Área de empleo. | STRING(4) |
| Información sobre el establecimiento | ||
| SIEGE | Indica si el establecimiento es la sede social. | STRING(1) |
| ENSEIGNE | Rótulo o nombre del establecimiento. | STRING(50) |
| IND_PUBLIPO | Indicador de campo de mailing directo. | STRING(1) |
| DIFFCOM | Estado de distribución del establecimiento. | STRING(1) |
| AMINTRET | Año y mes en que el establecimiento se añadió a la base de datos. | STRING(6) |
| Características económicas del establecimiento | ||
| NATETAB | Naturaleza del establecimiento de un empresario individual. | STRING(1) |
| LIBNATETAB | Etiqueta de naturaleza. | STRING(30) |
| APET700 | Actividad principal. | STRING(5) |
| LIBAPET | Etiqueta de actividad principal. | STRING(65) |
| DAPET | Año de validez de la actividad principal. | STRING(4) |
| TEFET | Tramo del número de empleados del establecimiento. | STRING(2) |
| LIBTEFET | Nombre del tramo. | STRING(23) |
| EFETCENT | Número de empleados del establecimiento, redondeado a la centena más cercana. | STRING(6) |
| DEFET | Año de validez de la plantilla del establecimiento. | STRING(4) |
| ORIGINE | Origen de creación del establecimiento. | STRING(2) |
| DCRET | Fecha de creación del establecimiento. | STRING(8) |
| DDEBACT | Fecha de inicio de actividad. | STRING(8) |
| ACTIVNAT | Naturaleza de la actividad del establecimiento. | STRING(2) |
| LIEUACT | Lugar de actividad del establecimiento. | STRING(2) |
| ACTISURF | Tipo de comercio. | STRING(2) |
| SAISONAT | Indica si la actividad del establecimiento es estacional. | STRING(2) |
| MODET | Tipo de la actividad principal del establecimiento. | STRING(1) |
| PRODET | Naturaleza productiva del establecimiento. | STRING(1) |
| PRODPART | Participación específica en la producción del establecimiento. | STRING(1) |
| AUXILT | Naturaleza auxiliar de la actividad del establecimiento. | STRING(1) |
| Identificación de la empresa | ||
| NOMEN_LONG | Nombre o razón social de la empresa. | STRING(131) |
| SIGLE | Rótulo o logotipo de la empresa. | STRING(20) |
| NOM | Nombre de nacimiento. | STRING(100) |
| PRENOM | Nombre de pila. | STRING(30) |
| CIVILITE | Tratamiento de los empresarios individuales. | STRING(1) |
| RNA | Número de identificación en el directorio nacional de asociaciones. | STRING(10) |
| Información sobre la sede de la empresa | ||
| NICSIEGE | Número de clasificación interno de la sede. | STRING(5) |
| RPEN | Región donde se ubica la sede. | STRING(2) |
| DEPCOMEN | Departamento o ciudad donde se ubica la sede. | STRING(5) |
| ADR_MAIL | Ya no se utiliza. | |
| TELEPHONE | Ya no se utiliza. | |
| Características económicas de la empresa | ||
| NJ | Naturaleza jurídica de la empresa. | STRING(4) |
| LIBNJ | Etiqueta de la naturaleza jurídica. | STRING(100) |
| APEN700 | Actividad principal de la empresa. | STRING(5) |
| LIBAPEN | Etiqueta de actividad principal. | STRING(65) |
| DAPEN | Año de validez de la actividad principal. | STRING(4) |
| APRM | Actividad principal en el registro mercantil. | STRING(6) |
| ESS | Pertenencia al ámbito de la economía social y solidaria. | STRING(1) |
| DATEESS | Fecha ESS. | STRING(8) |
| TEFEN | Tramo del número de empleados de la empresa. | STRING(2) |
| LIBTEFEN | Etiqueta del tramo. | STRING(23) |
| EFENCENT | Número de empleados del establecimiento, redondeado a la centena más cercana. | STRING(6) |
| DEFEN | Año de validez de la plantilla de la empresa. | STRING(4) |
| CATEGORIE | Categoría de la empresa. | STRING(5) |
| DCREN | Fecha de creación de la empresa. | STRING(8) |
| AMINTREN | Año y mes en que la empresa se añadió a la base de datos. | STRING(6) |
| MONOACT | Índice de monoactividad de la empresa. | STRING(1) |
| MODEN | Tipo de la actividad principal de la empresa. | STRING(1) |
| PRODEN / ESAANN / TCA / ESAAPEN / ESASEC1N–4N | Ya no se utiliza. | |
| Datos específicos de las actualizaciones | ||
| VMAJ | Naturaleza de la actualización: C creación del establecimiento; E baja del establecimiento; I modificación, estado inicial; F modificación, estado final; D entrada en distribución; O salida de distribución. |
STRING(1) |
| VMAJ1 / VMAJ2 / VMAJ3 | Ya no se utiliza. | |
| DATEMAJ | Fecha de tratamiento de la actualización. | STRING(19) |
Ejemplo de respuesta
Ejemplo de respuesta — ASSOCIATION SPORTIVE DECATHLON (forma extendida)
Errores
| Tipo de error | Solicitud de ejemplo | Respuesta |
|---|---|---|
Falta el parámetro Licence
|
https://{SERVER_ADDRESS}/SIRETINFO/?Siret={SIRET} |
400 Bad Request Error |
Parámetro Licence vacío |
https://{SERVER_ADDRESS}/SIRETINFO/?Siret={SIRET}&Licence= |
400 Bad Request Error |
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