# OF52 - Export offers CSV or JSON file asynchronously

Export status and files links can be retrieved by calling OF53.Get a CSV or JSON file that includes the offers updated and deleted since the last request date.

To ease testing processes, the minimum values for "megabytes_per_chunk" and "items_per_chunk" have been lowered on TEST and DEV environments.
Please adapt these values on PROD environments.

Call FrequencyRecommended usage: - Differential: every 5 minutes - Full: once per dayMaximum usage: - Differential: once per minute - Full: once per day

Endpoint: POST /api/offers/export/async

## Query parameters:

  - `shop_id` (integer)
    Use this parameter when your user has access to several shops. If not specified, the shop_id from your default shop will be used.

## Request fields (application/json):

  - `channel_codes` (array)
    List of the channel codes to filter with. If specified, only offers that can be sold on the specified channel(s) will be returned. If not, offers will be returned regardless of their channels.

  - `export_type` (string)
    Format of the generated files: CSV or JSON (value is either text/csv or application/json). Default to text/csv.
    Enum: "text/csv", "application/json"

  - `include_fields` (array)
    Specify which columns (CSV) or fields (JSON) will be returned. If specified, only the listed columns/fields will be returned, otherwise all will be returned. If combined with rename_fields, include_fields must use the original header/field names.

  - `include_inactive_offers` (boolean)
    When calling the API in full mode (i.e. when no last_request_date is provided), inactive offers are not returned. To retrieve both active and inactive offers, set this field to true.When calling the API in differential mode (i.e. when the last_request_date is provided), both active and inactive offers are returned. This field cannot be used in differential mode otherwise the call fails.

  - `items_per_chunk` (integer)
    The maximum number of items per chunk

  - `last_request_date` (string)
    Date and time of your last request.If provided, retrieves all offers updated since this date and time, including deleted and inactive offers.If not provided, retrieves all active offers only, unless otherwise specified in the include_inactive_offers field.

  - `megabytes_per_chunk` (integer)
    The maximum size in megabytes of a chunk

  - `rename_fields` (object)
    This is only supported for CSV export. Can be used to modify the name of the CSV headers. The expected format is a JSON object with the original fields as keys and the substitute as value. {"offer-id": "offerId", "shop-name":"shopName"}

  - `shipping_zones` (array)
    If the setting Export shipping charges and delivery times has been enabled, list of the shipping zones codes to filter with. If specified, only shipping information linked to the given zones will be returned. Otherwise, all shipping information for all zones will be returned.

## Response 200 fields (application/json):

  - `tracking_id` (string)
    The offer export tracking Id