# CreatePickup

Creates a pickup for a given process_id, customer and address
 A logistic order must be created prior requesting a pickup
  Must specify the provider and carrier to be used to create the pickup:
 - Returns UNIMPLEMENTED (gRPC code 12) if the provider is OPS,
 meaning it didn't generated any action. 
 - Returns InvalidArgument (gRPC code 3) if the combination of 
 return-method, providerand carrier is not supported.

Endpoint: POST /v1/processes/{process_id}/pickup
Version: 1.0.0

## Path parameters:

  - `process_id` (string, required)
    gets the reverse delivery info

## Request fields (application/json):

  - `carrier` (string)
    Carrier to be used for generating the pickup (DHL, UPS, Correos...)
must be available for the given provider

  - `customer` (object)
    Customer personal data

  - `customer.email` (string)

  - `customer.first_name` (string)

  - `customer.last_name` (string)

  - `customer.rever_id` (string)
    Unique ID in the rever platform

  - `ecommerce_id` (string)
    Ecommerce associated to this logistic order

  - `pickup_address` (object)
    Address where the package is going to be picked up

  - `pickup_address.address_line_1` (string)

  - `pickup_address.address_line_2` (string)

  - `pickup_address.city` (string)

  - `pickup_address.company` (string)

  - `pickup_address.country` (string)

  - `pickup_address.country_code` (string)

  - `pickup_address.phone` (string)

  - `pickup_address.postcode` (string)

  - `pickup_address.state_province` (string)

  - `pickup_address.state_province_code` (string)

  - `pickup_ranges` (array)
    Preferred times for the pickup a the customer address
    Enum: "NO_RANGE", "RANGE_8_TO_12", "RANGE_12_TO_16", "RANGE_16_TO_20"

  - `process_id` (string)
    Id of the process that the pickup is associated to

  - `provider` (string)
    Provider to be used for generating the pickup (SendCloud, OPS, etc).

  - `settings` (object)
    deprecated

  - `settings.logistic_config` (array)
    protolint:disable:next REPEATED_FIELD_NAMES_PLURALIZED

  - `settings.logistic_config.carrier` (string)
    carrier

  - `settings.logistic_config.provider` (string)
    provider

  - `settings.return_method` (string)
    Return method associated to the logistic order (PICKUP, DROP_OFF)
    Enum: "NO_RETURN_METHOD", "HOME_PICK_UP", "DROP_OFF_POINT", "DELIVERY_PICKUP", "IN_STORE"

## Response 200 fields (application/json):

  - `pickup_order` (object)
    Pickup order created if any

  - `pickup_order.carrier` (string)
    Carrier that was used to geenrate the pickup

  - `pickup_order.id` (string)
    Platform specific id of the pickup

  - `pickup_order.pickup_range` (object)
    Pickup Range

  - `pickup_order.pickup_range.from` (string)
    Start time of the pickup range

  - `pickup_order.pickup_range.to` (string)
    End time of the pickup range

  - `pickup_order.provider` (string)
    Provider that was used to generate the pickup