Editar - Subasta/Envio

PUT /api/auction/:serviceCode

Editar una subasta

Request

Path Parameters

serviceCode stringrequired

Header Parameters

apikey stringrequired

Apikey de una company vinculada a un usuario

application/json

Body

award_price int32

Valor de ganador directo. Si un transportista puja por este valor o menos; se le adjudicará directamente como ganad

bid_current integer

Puja actual ganadora.

cargo_height integer

Possible values: <= 4500

Default value: 0

Altura de la carga. Ten en cuenta el valor de is_imperial_measure para saber de cm/inch

cargo_weight integer

Possible values: <= 24000

Peso de la Carga. Ten en cuenta el valor del is_imperial_measure para saber si son kg/lb

date_end string

Possible values: non-empty

Fecha de fin de la subasta. Se aceptarán pujas hasta esta fecha. Si llegada esta fecha no hay pujas, se considera 'empty

date_start string

Possible values: non-empty

Fecha comienzo subasta. Se considera Draft si este campo es null; y planned, si tiene algún valor > NOW().

etd_address string

Possible values: >= 24 characters and <= 24 characters, Value must match regular expression ^[0-9a-fA-F]{24}$

Default value: 64f95ba1fd52766b7896025e

El _ID de la dirección seleccionada. Revisa la petición de listado de tus direcciones antes de poner un valor.

etd_cargo_method string

Tipo de método de carga en origen ('back', 'up', 'lateral')

etl_cargo_method string

Tipo de método de carga en destino ('back', 'up', 'lateral')

etd_date timestamp

Possible values: non-empty

Fecha de Entrega. En caso que haya un margen de tiempo, ten en cuenta la hora de comienzo

etl_address string

Possible values: >= 24 characters and <= 24 characters, Value must match regular expression ^[0-9a-fA-F]{24}$

Default value: 64f95ba1fd52766b7896025e

El _ID de la dirección seleccionada. Revisa la petición de listado de tus direcciones antes de poner un valor.

etl_date timestamp

Possible values: non-empty

Fecha de Recogida. En caso que haya un margen de tiempo, ten en cuenta la hora de comienzo

fresh_cargo_temp integer

Possible values: >= -273 and <= 1000

Default value: 0

En caso que is_fresh a True, este valor el Requerido. Y será la temperatura optima de carga

had_etd_cargo_method had_etd_cargo_method_2 (boolean)

Si hay metodos de carga en destino

had_etl_cargo_method had_etl_cargo_method (boolean)

Si hay metodos de carga en origen

is_fresh boolean

Si es un camión refriguerado o no. Por defecto, no

is_imperial_measure boolean

Para marcar si usaremos Metricas imperiales (Libras, pulgadas) o Metricas Decimales (cm, kg)

is_pallet boolean

Si el envío es paletizado. Revisar el campo cargo_type

owner string

ID del creador de la subasta.

pallets_num integer

Possible values: <= 66

Default value: 0

Numero de pallets en el Envío

pallets_type string

Possible values: non-empty, [european, american, none]

Default value: european

Tipo de Pallet a usar. Se usará para calculos de volumen, medidas y comprobaciones legales. Tiene en cuenta el valor del campo is_pallet

start_price integer

Default value: 0

Es el precio de salida de la subasta. Ten en cuenta que si es un valor menor al minimo por el calculo de ruta, fallará la inserción

status string

Possible values: [draft, planned, published, empty, awarded, approved, locked, canceled, rejected]

Es el estado actual de la subasta. No será editable se modificará el estado dependiendo de los valores, condiciones de la subasta. draft - Borrador planned - Planificada published - Publicada empty - Desierta, sin Pujas awarded - Adjudicada approved - Aprobada, en proceso de Envío canceled - Cancelada por la Company rejected - Rechazada por el Trucker

user string

ID del usuario asociado a la subasta.

Responses

Example response

application/json

Schema
Example (from schema)

Schema

status string

data object

Este es el objeto completo de Subasta. Ten en cuenta que habrá campos que sean de uso interno de la base de datos o del servidor y no se podrán modificar con la edición o creación del objeto.

Los Objetos relacionados y los listados de objetos; en el momento de la creación y edición NO son necesarios poner el objeto completo, será solo necesrio poner el _id correspondiente del objeto.

_id string

Possible values: non-empty, Value must match regular expression ^[0-9a-fA-F]{24}$

Id de uso interno de la base datos

bids_count integer

Default value: 0

Numero de Pujas en la Subasta

cancelled_company_date timestamp

Possible values: non-empty

Fecha en la que ha sido cancelado por la Compañia

cancelled_trucker_date timestamp

Possible values: non-empty

Fecha en la que ha sido cancelado por el Transportista (TruckerCia)

cargo_height integer

Possible values: <= 4500

Default value: 0

Altura de la carga. Ten en cuenta el valor de is_imperial_measure para saber de cm/ En caso quwe no se envíe dato en la creación, se tomará la altura máxima de un pallet para ello .

cargo_type stringrequired

Possible values: [pallets, full, package, trailer]

Tipo de Envío: Bulto, Paletizado, CArga Completa, Metros Lineales

cargo_weight integerrequired

Possible values: <= 24000

Peso de la Carga. Ten en cuenta el valor del is_imperial_measure para saber si son kg/lb

createdAt timestamp

Possible values: non-empty

custom_code string

Possible values: <= 560 characters

Este campo será de uso interno (tuyo) para la organización de las subastas y de loas entregaas.

date_end stringrequired

Possible values: non-empty

Fecha de fin de la subasta. Se aceptarán pujas hasta esta fecha. Si llegada esta fecha no hay pujas, se considera 'empty

date_start stringrequired

Possible values: non-empty

Fecha comienzo subasta. Se considera Draft si este campo es null; y planned, si tiene algún valor > NOW().

deletedAt timestamp

Possible values: non-empty

email_end_notified boolean

Su valor será true en caso que se haya mandando las notificaciones al terminar

etd_address objectrequired

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.

_id string

Possible values: non-empty, Value must match regular expression ^[0-9a-fA-F]{24}$

Id de uso interno de la base datos

city string

Possible values: non-empty

Ciudad de la dirección

company_name stringrequired

Possible values: non-empty

Nombre de la compañia destino. Será usada para verificación de datos

country stringrequired

Possible values: >= 3 characters and <= 20 characters

https://en.wikipedia.org/wiki/List_of_ISO_3166_country_codes

location objectrequired

Posicion GPS de localización

name string

Possible values: non-empty

Nombre (o apodo) que le das a la dirección para tu uso

name_address stringrequired

Possible values: non-empty

Dato completo

phone string

Possible values: non-empty

Telefono de contacto del usuario

province string

Possible values: non-empty

Provincia de la dirección

state string

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

street_address string

Possible values: non-empty

Dirección Fisica; calle, avenida, etc

street_number string

Possible values: non-empty

Numero de Portal de la dirección

zipcode stringrequired

Possible values: non-empty

Codigo Postal de la dirección. Dependerá del pais para el uso de un formato u otro.

etd_cargo_method string

Possible values: non-empty, [back, lateral, superior]

Default value: back

En caso que haya un metodo de Carga o una acceso al dock de carga determinado en el Origen de l viaje.

etd_date timestamp

Possible values: non-empty

Fecha de Entrega. En caso que haya un margen de tiempo, ten en cuenta la hora de comienzo

etd_extra_time integer

Possible values: <= 99999

Default value: 0

Tiempo rango extra desde el etd_date., Corresponden al numero de minutos entre la fecha de entrega y el rango horario. Por ejempo Si la etd_date está a las 08:00 la hora, esto será el numero de minutos para la entreega a las 08:05

etl_address object

_id string

Possible values: non-empty, Value must match regular expression ^[0-9a-fA-F]{24}$

Id de uso interno de la base datos

city string

Possible values: non-empty

Ciudad de la dirección

company_name stringrequired

Possible values: non-empty

Nombre de la compañia destino. Será usada para verificación de datos

country stringrequired

Possible values: >= 3 characters and <= 20 characters

https://en.wikipedia.org/wiki/List_of_ISO_3166_country_codes

location objectrequired

Posicion GPS de localización

name string

Possible values: non-empty

Nombre (o apodo) que le das a la dirección para tu uso

name_address stringrequired

Possible values: non-empty

Dato completo

phone string

Possible values: non-empty

Telefono de contacto del usuario

province string

Possible values: non-empty

Provincia de la dirección

state string

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

street_address string

Possible values: non-empty

Dirección Fisica; calle, avenida, etc

street_number string

Possible values: non-empty

Numero de Portal de la dirección

zipcode stringrequired

Possible values: non-empty

Codigo Postal de la dirección. Dependerá del pais para el uso de un formato u otro.

etl_cargo_method string

Possible values: non-empty, [back, lateral, superior]

Default value: back

Metodos de carga permitidos para la carga en ETL

etl_date timestamp

Possible values: non-empty

Fecha de Recogida. En caso que haya un margen de tiempo, ten en cuenta la hora de comienzo

etl_extra_time integer

Possible values: <= 9999

Default value: 0

Tiempo rango extra desde el etl_date., Corresponden al numero de minutos entre la fecha de recogida y el rango horario. Por ejempo Si la etd_date está a las 08:00 la hora, esto será el numero de minutos para la entreega a las 08:05

fresh_cargo_temp integer

Possible values: >= -30 and <= 10

Default value: 0

En caso que is_fresh a True, este valor el Requerido. Y será la temperatura optima de carga

had_etd_cargo_method boolean

Dispone de metodo de carga en Destino

had_etl_cargo_method had_etd_cargo_method (boolean)

Dispone de metodo de carga en Origen

hscode string

Codigo de Harminnozción Europeo. https://trade.ec.europa.eu/access-to-markets/en/content/harmonised-system-0

is_fresh boolean

Si el envío es refrigerado. Revisar el campo fresh_cargo_temp

is_imperial_measure boolean

Para marcar si usaremos Metricas imperiales (Liubras, pulgadas) o Metricas Decimales (cm, kg)

is_pallet boolean

Si el envío es paletizado. Revisar el campo cargo_type

linear_meters integer

Default value: 0

En caso que el carto_type sea "bulto" se tendrá en cuenta para calculo del volumen. Serán los mettros longitudinales de la carga

pallets_num integer

Possible values: <= 66

Default value: 0

Numero de pallets en el Envío

pallets_type string

Possible values: non-empty, [european, american, none]

Default value: european

Tipo de Pallet a usar. Se usará para calculos de volumen, medidas y comprobaciones legales. Tiene en cuenta el valor del campo is_pallet

plate_full_trailer string

Matricula del remolque, en caso de que el tipo de envío sea un remoqule directamente. Solo es aplicable en el tipo de cargo_type correspondiente.

service_code string

Id Unico dentro de la plataforma de Cargofer; se genera de forma automatica en la creación, y no se podrá repetir.

Sirve como código de trazabilidad de todo el envío, desde la creación a la entrega.

sign_image_cia string

Imagen de Firma del Cargador. Está en formato Base64

sign_image_trucker string

Imagen de Firma del Transportista; solo podría modificarse si aún no se ha firmado por ambas partes,. Está en formato Base64

signed_by_company boolean

Se cambia automaticamente cuando el Company/CArgador ha firmado; se usa para comprobaciones más sencillas.

signed_by_company_date timestamp

Possible values: non-empty

Fecha en la que ha sido firmado por la Company/Cargador. Se genera automaticamente en el servidor cuando se suba e firma correspondiente.

signed_by_company_notify boolean

Si ha sido notificado para firmar a Transportista (TruckerCia)

signed_by_trucker boolean

Si ha sido firmado por el Transportista (TruckerCia)

signed_by_trucker_date timestamp

Possible values: non-empty

Fecha en la que ha sido firmado por el Transportista (TruckerCia)

signed_by_trucker_notify boolean

Si ha sido notificado para firmar a la Compañia (Cargador)

status string

Possible values: [draft, planned, published, empty, awarded, approved, locked, canceled, rejected]

Default value: draft

Es el estado actual de la subasta. No será editable se modificará el estado dependiendo de los valores, condiciones de la subasta. draft - Borrador; no es publico y es editable planned - Planificada; Se puede bloquear. Aun no recibe pujas, por que no entró en tiempo de puja. published - Publicada empty - Desierta, sin Pujas awarded - Adjudicada approved - Aprobada, en proceso de Envío; ya no es editable. Y está asociada a un delivery. canceled - Cancelada por la Company rejected - Rechazada por el Trucker

updatedAt timestamp

Possible values: non-empty

Fecha de la ultima modificación del objeto

{
  "status": "string",
  "data": {
    "_id": "string",
    "bids_count": 0,
    "cancelled_company_date": "2019-09-20T16:03:18.575Z",
    "cancelled_trucker_date": "2019-09-20T16:03:18.575Z",
    "cargo_height": 0,
    "cargo_type": "pallets",
    "cargo_weight": 2500,
    "createdAt": "2019-09-20T16:03:18.575Z",
    "custom_code": "REF2024-0101",
    "date_end": "2019-09-20T16:03:18.575Z",
    "date_start": "2019-09-20T16:03:18.575Z",
    "deletedAt": "2019-09-20T16:03:18.575Z",
    "email_end_notified": false,
    "etd_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"
    },
    "etd_cargo_method": "back",
    "etd_date": "2019-09-20T16:03:18.575Z",
    "etd_extra_time": 1,
    "etl_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"
    },
    "etl_cargo_method": "back",
    "etl_date": "2019-09-20T16:03:18.575Z",
    "etl_extra_time": 100,
    "fresh_cargo_temp": 3,
    "had_etd_cargo_method": false,
    "had_etl_cargo_method": false,
    "hscode": "0706.10",
    "is_fresh": false,
    "is_imperial_measure": false,
    "is_pallet": false,
    "linear_meters": 0,
    "pallets_num": 0,
    "pallets_type": "european",
    "plate_full_trailer": "1234-CDD",
    "service_code": "ACOMALg4667",
    "sign_image_cia": "string",
    "sign_image_trucker": "string",
    "signed_by_company": false,
    "signed_by_company_date": "2019-09-20T16:03:18.575Z",
    "signed_by_company_notify": false,
    "signed_by_trucker": false,
    "signed_by_trucker_date": "2019-09-20T16:03:18.575Z",
    "signed_by_trucker_notify": false,
    "status": "draft",
    "updatedAt": "2019-09-20T16:03:18.575Z"
  }
}

Editar - Subasta/Envio

/api/auction/:serviceCode

Request​

Path Parameters

Header Parameters

Body

Responses​

Request

Responses