# Sharing order events via CSV

You can submit order events as CSV files to Hakuna so we can create and manage the insurance contracts appropriately. 

{% hint style="info" %}
This guide outlines the general requirements for sharing order events via CSV. If you are interested in this approach, please inform your Hakuna Account Manager. They will work with you to establish the specific requirements for your use case.
{% endhint %}

## File requirements

The CSV file must be comma separated and UTF-8 encoded.

The file name must be unique.

Each row in the CSV file should represent an item in an order, with data identifying:

* the order ID
* the date and time at which the order was placed
* if cancelled, the date and time at which the order was cancelled
* if fulfilled, the date and time at which the line item was fulfilled
* if refunded, the date and time at which the line item was refunded
* the customer details (name, email, address)
* the product details (line item ID, product ID, brand, title, price amount and currency)

All protection products should also have a reference to the product for which the protection was purchased.

If a product has a quantity of 2, it should be represented by two rows. Protection products should also be represented as separate rows.

You can determine the file structure (e.g., data formatting, column titles, etc.) based on what is available to you. Hakuna will transform and ingest the data into our platform as needed.

## Upload

We will provide you with a AWS account with access to a shared S3 bucket where you can upload the CSV files using the AWS console.

## Frequency

You can choose the frequency of data submission. New uploads will be processed immediately, as long as they have a unique file name.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.hellohakuna.com/sharing-order-events/sharing-order-events-via-csv.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.