# Calculate available PUDOs

Calculate the PUDOs can be used to ship the items. The PUDOs are calculated based on a reference address. Before call this endpoint, the list of avaiable return methods should be calculated in order to obtain the carrier data. It is mandatory to inform either the address or the geolocation data

Endpoint: POST /pudos
Version: 1.4.2
Security: bearerAuth

## Request fields (application/json):

  - `shopCode` (string)
    Shop code which belongs the shipment. In case this field is not informed, it will be obtained from security context. In case it is informed, it will be validated against the security context
    Example: "marchelacolombine"

  - `carrierServices` (array, required)
    List of carrier service connections from which the PUDOs will be obtained
    Example: [{"code":"IF-UPS-EXPRESS-SAVER"},{"code":"IF-SEUR-HOME2SHOP"}]

  - `carrierServices.code` (string, required)
    Code of the carrier service connection

  - `limit` (number)
    Number of PUDOs to be listed
    Example: 10

  - `address` (string)
    Reference address information
    Example: "C. Juan de Mena 8"

  - `city` (string)
    City of the reference address
    Example: "Madrid"

  - `postalCode` (string)
    Postal code of the reference address
    Example: "28010"

  - `countryCode` (string)
    Country code of the reference address
    Example: "ES"

  - `latitude` (number)
    Latitude of the reference address. If this field is informed will have more priority than address
    Example: 40.323132

  - `longitude` (number)
    Longitude of the reference address. If this field is informed will have more priority than address
    Example: -3.434343

  - `range` (number)
    Range search area in km. Min 1 and Max 20
    Example: 10

  - `locationType` (string)
    Optional parameter used to filter PUDOs by location type. By default all location types are listed.
    Enum: "ALL", "STORE_POINT", "LOCKER_POINT"

## Response 200 fields (application/json):

  - `carrierCode` (string)
    Carrier code associated with the PUDOs
    Example: "ups"

  - `carrierExternalCode` (string)
    Carrier code associated with the PUDOs
    Example: "20000008"

  - `pudoPoints` (array)
    List of available PUDOs for the carrier

  - `pudoPoints.id` (string)
    ID of the PUDO
    Example: "P232"

  - `pudoPoints.name` (string)
    Name of the PUDO
    Example: "ABC Book Store"

  - `pudoPoints.email` (string)
    Email associated to the PUDO
    Example: "pudo@email.com"

  - `pudoPoints.phone` (string)
    Phone associated to the PUDO
    Example: 34666666666

  - `pudoPoints.address` (string)
    Address of the PUDO
    Example: "C. Ibiza 200"

  - `pudoPoints.city` (string)
    City name of the PUDO address
    Example: "Madrid"

  - `pudoPoints.postalCode` (string)
    Postal code of the PUDO address
    Example: "28020"

  - `pudoPoints.region` (string)
    Region name of the PUDO address
    Example: "Madrid"

  - `pudoPoints.countryCode` (string)
    Country ISO code of PUDO address
    Example: "ES"

  - `pudoPoints.latitude` (string)
    Latitude for the PUDO address
    Example: 40.393132

  - `pudoPoints.longitude` (string)
    Longitude for the PUDO address address
    Example: -3.723233

  - `pudoPoints.image` (string)
    Image associated to the PUDO
    Example: "https://pudo.com/image.jpeg"

  - `pudoPoints.openingHours` (array)
    Opening hours of the PUDO

  - `pudoPoints.openingHours.dayOfWeek` (number)
    Day of the week. Start at 1-Monday
    Example: 1

  - `pudoPoints.openingHours.hours` (array)
    Example: ["9:30-13:00"]

## Response 400 fields (application/json):

  - `errors` (array)

  - `errors.code` (string)
    Error code
    Example: "VA001"

  - `errors.message` (string)
    Error message
    Example: "The origin address is not valid"

  - `errors.carrierErrors` (array)

  - `errors.carrierErrors.carrierName` (string)
    Example: "SEUR"

  - `errors.carrierErrors.carrierService` (string)
    Example: "RETHOME"

  - `errors.carrierErrors.code` (string)
    Example: "ER001"

  - `errors.carrierErrors.message` (string)
    Example: "Zip code for sender address has an incorrect format"


## Response 401 fields

## Response 405 fields

## Response 500 fields