Listado Cargadores
GET/api/company
Un listado de los cargadores que están asociados a la cuenta que está haciendo la peticion.
Puede ser para Integradores o Afiliados.
Request
Query Parameters
Default value: 1
Pagina a Consultar, Default 1. En caso que se envíe una pagina que no exista se cambiará en back por la ultima
Elementos por Pagina, Default 25
Header Parameters
Apikey de una company vinculada a un usuario
Responses
- 200
Listado de las compañias cargadoras que tiene asociado el usuario actual. Puede ser un Integrador o un Afiliado.
En el caso del Integrador; las compañias pueden ser gestionadas para editar o generar subastas y pujas, en representación de la compania cargador.
En el caso de los Afiliados; las compañias serán puramente de lectura para asegurar que corresponden con las que ha referenciado el afiliado en la creación.
- application/json
- Schema
- Example (from schema)
- Example 1
Schema
- Array [
- ]
- Array [
- ]
- Array [
- ]
- Array [
- ]
Default value: 200
data object
companies object
Compañia Cargadora que es el origen de la subasta. Ya sea multitennant o Default. OJO: En el APi-Rest NO se permite la edición de estos datos, serán readOnly
Possible values: non-empty
, Value must match regular expression ^[0-9a-fA-F]{24}$
Id de uso interno de la base datos
Possible values: [default
, multitennant
, mining
, custom
]
Default value: default
Tipo de compañia: default -> Habitual ; la usa para publicar sus necesidades de carga y llevar el seguimiento. multitennant -> Tiene flota propia y contrata servicios externos Spot mining -> Especial para mineria custom - Cueta especial hecha a medida del cliente.
address object
Direcciones de Envío / Recogida. Son necesarias para que el calculo de costes, rutas y funcionamiento general de la plataforma sea correcto. Ten en cuenta que usaremos tanto la posición GPS como el código postal para gestinar y comprobar que todos los datos son correctos; por lo que es importante que estén correctos. En caso que algún dato esté mal introducido; ten en cuenta que serán registrados en el contrato y todos los documentos legales del proceso.
Possible values: non-empty
, Value must match regular expression ^[0-9a-fA-F]{24}$
Id de uso interno de la base datos
Possible values: non-empty
Ciudad de la dirección
Possible values: non-empty
Nombre de la compañia destino. Será usada para verificación de datos
Possible values: >= 3 characters
and <= 20 characters
https://en.wikipedia.org/wiki/List_of_ISO_3166_country_codes
Posicion GPS de localización
Possible values: non-empty
Nombre (o apodo) que le das a la dirección para tu uso
Possible values: non-empty
Dato completo
Possible values: non-empty
Telefono de contacto del usuario
Possible values: non-empty
Provincia de la dirección
Possible values: non-empty
Provincia o Comunidad de la dirección. En caso de no ser compatible con el formato de la dirección puede quedar vacio
Possible values: non-empty
Dirección Fisica; calle, avenida, etc
Possible values: non-empty
Numero de Portal de la dirección
Possible values: non-empty
Codigo Postal de la dirección. Dependerá del pais para el uso de un formato u otro.
addresses object[]
Direcciones de Clientes. Usadas para Origen/Destino de las Auctions
Possible values: non-empty
, Value must match regular expression ^[0-9a-fA-F]{24}$
Id de uso interno de la base datos
Possible values: non-empty
Ciudad de la dirección
Possible values: non-empty
Nombre de la compañia destino. Será usada para verificación de datos
Possible values: >= 3 characters
and <= 20 characters
https://en.wikipedia.org/wiki/List_of_ISO_3166_country_codes
Posicion GPS de localización
Possible values: non-empty
Nombre (o apodo) que le das a la dirección para tu uso
Possible values: non-empty
Dato completo
Possible values: non-empty
Telefono de contacto del usuario
Possible values: non-empty
Provincia de la dirección
Possible values: non-empty
Provincia o Comunidad de la dirección. En caso de no ser compatible con el formato de la dirección puede quedar vacio
Possible values: non-empty
Dirección Fisica; calle, avenida, etc
Possible values: non-empty
Numero de Portal de la dirección
Possible values: non-empty
Codigo Postal de la dirección. Dependerá del pais para el uso de un formato u otro.
contact_person object
Datos de la persona de contacto de una empresa. En el momento de registro de una empresa serán rellenados con los datos del formulario; yt luego podrán ser editados manualmente para especficar.
Será usado para el envíos de correos, comunicación e incidencias.
Nombre de la persona de contacto.
Primer apellido de la persona de contacto
Email de contacto. Caundo se cree una Compañia será rellenado con el dato de ladel registro
invoice_data objectrequired
Datos de la facturación. Se usan para la generación de las facturas y para los enlaces fiscales correspondientes.
NIF/DNI de la empresa, o numero fiscal
Possible values: Value must match regular expression 32435454N
Telefono de contacto de la dirección
Dirección completa: GO Fit, Calle de la Verdad, Opañel, Carabanchel, Madrid, Comunidad de Madrid, 28019, España
Possible values: non-empty
Nombre Comercial de la compañia
Possible values: [BAD_USER
, NONE
, PENDING
, ACTIVE
, BLOCKED
]
Default value: NONE
Explicación del Bloqueo de la compañia. Ver status
Possible values: non-empty
Nombre Legal de la compañia. Será usado para los documentos legales
Si el usuario está habilitado o no para entrar en la plataforma, se aplica a todos los truckers asociados En caso de False; los datos de reason y reasonMessage tendrán inf
Cuando se registra una nueva compñai; hay que validar el correo del admin antes de poder ser true. Es modificado en el servidor. ción
truckers object[]
Conductores de la Compañia; estos tendrán acceso a la aplicación de transportistas con acceso a los servicios gestionados desde el panel de Company MultiTennant. para cuentas Multitennant
position object
Array de servicios y su última posición conocida
Rol de la cuenta ("driver", "dev", "gestor" o "admin")
Estado de la cuenta (Bloqueado o activo en booleano).
Razón de bloqueo de la cuenta.
Booleano que indica si está el email verificado.
Teléfono del camionero.
País de residencia del camionero.
Zona horaria del camionero.
Imagen del camionero.
Token de recuperación de contraseña.
Idioma del usuario camionero.
Booleano que indica si el usuario ha sido borrado.
Nombre del camionero.
Apellido del camionero.
Email del camionero (Debe ser único)
Documento de identidad del camionero (Debe ser único).
Contraseña hasheada de la cuenta de camionero.
users object[]
Possible values: >= 1
Los usuarios de la compañia
Possible values: non-empty
ID unico generado aleatoriamente en el momento de creación
Possible values: non-empty
Fecha de nacimiento del Usuario
Possible values: non-empty
https://en.wikipedia.org/wiki/List_of_ISO_3166_country_codes
Possible values: non-empty
TimeStamp de la creación del objeto
Possible values: non-empty
Email usado para el Login. Debe ser unico en el el sistema
Boolean para saber si un usuario ha validado el correo. No se podrá conectar si no está validado
Possible values: >= 2 characters
and <= 3 characters
Codigo ISO del idioma Actual
Possible values: non-empty
TimeStamp del ultimo Login de usuario
Possible values: non-empty
Ultima IP desde la que se ha conectado el usuario
Possible values: non-empty
Apellido del Usuario
Possible values: non-empty
Nombre del Usuario
Possible values: non-empty
Telefono de contacto del usuario
Código de fichero de photo (Optional)
Possible values: non-empty
Timestamp de cuando se ha pedido el reseteo de password
Possible values: non-empty
, [gestor
, admin
]
Default value: gestor
Role del usuario. En caso de ser Gestor, podrá crear drivers para su Company. Siempre tiene que haber 1 admin
Possible values: [pending
, active
, suspended
, blocked
]
Default value: pending
Si el usuario está habilitado o no para entrar en la plataforma. Pending -> Pendiente de Aprobar Active -> Puede Usar la plataforma Suspended -> Bloqueado Temporalmente Blocked -> Bloqueado de forma Permanente
Possible values: non-empty
https://en.wikipedia.org/wiki/List_of_tz_database_time_zones
Possible values: non-empty
TimeStamp de la ultima actualización del Objeto
Si los datos de la base de datos se han borrado o no. En caso que sea true, los datos serán de solo lectura y no se podran modificar. Se mantienen por cohrencia de información o por que son necesarios para documentos cruzados
vehicles object[]
Listado de los vehiculos internos de la compañia; para cuentas Multitennant
Tipos de metodos de carga validos para el camión ("NONE", "up", "lateral", "back")
Tipo de camión ("NONE", "r3c", "tir", "rt", "r2c", "r2d", "van", "frc", "f2c", "adr", "ft", "pt", "cc", "hdcc", "dump", "live" o "cocar")
Imagén del camión.
Documento de ITV del camión.
Camión refrigerado o seco ("fresh" o "dry")
Matricula del camión.
Temperatura a la que puede llegar el camión en caso de ser refrigerado, en grados Celsius.
Si tiene configurado o no la firma de la empresa. Es necesario para poder generar las subastas y para generar la documentacion de los eCMR
Este objeto será rellenado de forma automatica con el enlace de Stripe para la facturación. En casos especiales y cuentas custm puede que no tenga uinformación o sea null/undefined.
{
"status": 200,
"data": {
"companies": {
"_id": "667be7657b28b3d0a3fc6950",
"accountType": "default",
"address": {
"_id": "5d84f846b0f6ba698f544dbf",
"city": "vigo",
"company_name": "ABC Logistics",
"country": "españa",
"location": {
"coordinates": [
-8.7207,
42.2406
],
"type": "Point"
},
"name": "ABC Logistics Vigo",
"name_address": "Aduana, 4, Rúa Concepción Arenal, Santiago de Vigo, Vigo, Pontevedra, Galicia, 36201, España",
"phone": "+34981234567",
"province": "Pontevedra",
"state": "galicia",
"street_address": "Rúa Concepción Arenal",
"street_number": "4",
"zipcode": "36201"
},
"addresses": [
{
"_id": "5d84f846b0f6ba698f544dbf",
"city": "vigo",
"company_name": "ABC Logistics",
"country": "españa",
"location": {
"coordinates": [
-8.7207,
42.2406
],
"type": "Point"
},
"name": "ABC Logistics Vigo",
"name_address": "Aduana, 4, Rúa Concepción Arenal, Santiago de Vigo, Vigo, Pontevedra, Galicia, 36201, España",
"phone": "+34981234567",
"province": "Pontevedra",
"state": "galicia",
"street_address": "Rúa Concepción Arenal",
"street_number": "4",
"zipcode": "36201"
}
],
"contact_person": {
"name": "string",
"lastname": "string",
"email": "string",
"phone": "string"
},
"invoice_data": {
"taxid": "32435454N",
"email": "test@mail.com",
"phone": "+34123456789",
"name_address": "string"
},
"name": "Cargoffer",
"reason": "NONE",
"reasonMessage": "string",
"socialName": "string",
"status": "pending",
"truckers": [
{
"_id": "65e1fc46a39d32135b12c7e0",
"position": {
"deliveries": []
},
"role": "driver",
"status": true,
"reason": "NONE",
"emailVerified": false,
"phone": "34668936908",
"country": "esp",
"timezone": "europe/madrid",
"image": "",
"recovery_token": "XXX",
"i18n": "es",
"deleted": false,
"name": "Name",
"lastname": "Lastname",
"email": "email@example.com",
"taxid": "12345678A",
"password": "XXX"
}
],
"users": [
{
"_id": "5d84f846b0f6ba698f544dbf",
"authenticationToken": "string",
"birthDate": "2019-09-20T16:03:18.575Z",
"country": "ESP",
"createdAt": "2019-09-20T16:03:18.575Z",
"email": "string",
"emailVerified": true,
"lastSignInAt": "2019-09-20T16:03:18.575Z",
"lastSignInIp": "192.168.1.0",
"lastname": "string",
"name": "string",
"password": "string",
"phone": "+34 602247084",
"resetPasswordSentAt": "2019-09-20T16:03:18.575Z",
"resetPasswordToken": "NO-VISIBLE",
"role": "admin",
"status": true,
"timezone": "string",
"updatedAt": "2019-09-20T16:03:18.575Z"
}
],
"deleted": false,
"vehicles": [
{
"_id": "65e1f94fc5953704852eb5a3",
"cargo_type": [
"back",
"lateral"
],
"vehicle_type": "rt",
"image": "",
"itv": "",
"shipping_type": "dry",
"plate": "0017bbb"
}
],
"hasSign": false,
"createdAt": "2024-07-15T10:41:19.260Z",
"updatedAt": "2024-07-15T10:41:19.260Z",
"payment_settings": {}
}
}
}
{
"status": 200,
"data": {
"companies": [
{
"address": {
"location": {
"type": "Point",
"coordinates": [
-3.718497,
40.393065
]
},
"email": "testIntegrador4@gmail.com",
"phone": "123456789",
"street_address": "Calle de la Verdad",
"street_number": "",
"city": "Madrid",
"state": "Comunidad de Madrid",
"country": "españa",
"zipcode": "28019",
"neighborhood": "Carabanchel",
"name_address": "GO Fit, Calle de la Verdad, Opañel, Carabanchel, Madrid, Comunidad de Madrid, 28019, España",
"timezone": "utc"
},
"invoice_data": {
"taxid": "54652145A",
"bank_account": "",
"account_holder": "",
"email": "",
"name_address": "",
"phone": "+34111222333"
},
"contact_person": {
"email": "",
"lastname": "",
"name": "",
"phone": "+34111222333"
},
"payment_settings": {
"invoices": [],
"stripe_customer": "cus_QMFSJ8eBl10C7l"
},
"_id": "667aa0feeeb681322081cc3e",
"addresses": [
"667aa0feeeb681322081cc3d",
"667bc11d94702e9e8d2e9cb2"
],
"status": false,
"reason": "PENDING",
"reasonMessage": "PENDING_CIA",
"users": [
"667aa108eeb681322081cc43"
],
"accountType": "default",
"vehicles": [],
"truckers": [],
"hasSign": false,
"deleted": false,
"name": "Test Integrador",
"socialName": "Test Integrador SL",
"createdAt": "2024-06-25T10:50:39.030Z",
"updatedAt": "2024-06-26T07:19:57.556Z",
"__v": 2
},
{
"address": {
"location": {
"type": "Point",
"coordinates": [
-8.865306,
42.792581
]
},
"street_number": "",
"email": "testIntegrador5@gmail.com",
"phone": "987654321",
"street_address": "AC-311",
"city": "Noia",
"state": "Galicia",
"country": "españa",
"zipcode": "15201",
"neighborhood": "Corral de Ousoño",
"province": "A Coruña",
"name_address": "AC-311, Corral de Ousoño, A Fialla, Barro, Noia, A Coruña, Galicia, 15201, España",
"timezone": "utc"
},
"invoice_data": {
"bank_account": "",
"account_holder": "",
"taxid": "12345678P",
"email": "testIntegrador5@gmail.com",
"phone": "987654321",
"name_address": "AC-311, Corral de Ousoño, A Fialla, Barro, Noia, A Coruña, Galicia, 15201, España"
},
"contact_person": {
"name": "Test",
"lastname": "Integrador",
"email": "testIntegrador5@gmail.com",
"phone": "987654321"
},
"payment_settings": {
"invoices": [],
"stripe_customer": "cus_QMJ3GWR8GYi5sV"
},
"_id": "667ad54d1615e536ac8ae7cb",
"addresses": [
"667ad54d1615e536ac8ae7ca"
],
"status": false,
"reason": "PENDING",
"reasonMessage": "PENDING_CIA",
"users": [
"667ad5511615e536ac8ae7d0"
],
"accountType": "default",
"vehicles": [],
"truckers": [],
"hasSign": false,
"deleted": false,
"name": "Testing update",
"socialName": "Test Integrador SL",
"createdAt": "2024-06-25T14:33:49.107Z",
"updatedAt": "2024-06-26T06:29:53.669Z",
"__v": 1
},
{
"address": {
"location": {
"type": "Point",
"coordinates": [
-3.718497,
40.393065
]
},
"street_number": "",
"timezone": "utc",
"email": "testIntegrador6@gmail.com",
"phone": "123456789",
"street_address": "Calle de la Verdad",
"city": "Madrid",
"state": "Comunidad de Madrid",
"country": "españa",
"zipcode": "28019",
"neighborhood": "Carabanchel",
"name_address": "GO Fit, Calle de la Verdad, Opañel, Carabanchel, Madrid, Comunidad de Madrid, 28019, España",
"name": "Test Integrador SL",
"company_name": "Test Integrador SL"
},
"invoice_data": {
"bank_account": "",
"account_holder": "",
"taxid": "32435434N",
"email": "testIntegrador6@gmail.com",
"phone": "123456789",
"name_address": "GO Fit, Calle de la Verdad, Opañel, Carabanchel, Madrid, Comunidad de Madrid, 28019, España"
},
"contact_person": {
"name": "Test",
"lastname": "Integrador",
"email": "testIntegrador6@gmail.com",
"phone": "123456789"
},
"payment_settings": {
"invoices": [],
"stripe_customer": "cus_QMYUYpoFKoJ50P"
},
"_id": "667bb585e8c3bc2584b96ccc",
"addresses": [
"667bb585e8c3bc2584b96ccb"
],
"status": false,
"reason": "PENDING",
"reasonMessage": "PENDING_CIA",
"users": [
"667bb585e8c3bc2584b96cd1"
],
"accountType": "default",
"vehicles": [],
"truckers": [],
"hasSign": false,
"deleted": false,
"name": "Test Integrador",
"socialName": "Test Integrador SL",
"createdAt": "2024-06-26T06:30:29.786Z",
"updatedAt": "2024-06-26T06:30:30.398Z",
"__v": 1
}
]
}
}