# Feed order, customer & product data

## Overview

This guide walks you through how to include additional data to your shipments and trackers. These extra order and customer data will greatly improve your experience inside the platform as well as allow you to send proactive notifications to your customers.

## Get our GraphQL Playground running

To follow along the the steps in this guide we'll provide an interactive environment for Ruby, Python and Node. You can also use GraphQL directly with our [GraphQL Playground](/kublau-docs/api/playground.md).

## **Creating a customer**

**Customers** represent your users in Kublau’s API and allow you to send proactive notifications. It also serves as valuable reference information for a tracker or shipment.

{% hint style="info" %}
In order to connect a customer with a **Tracker** or **Shipment** you'll need to create an [**Order**](/kublau-docs/guides/including-order-and-customer-data.md#including-order-data).
{% endhint %}

Here is an example of how to create a customer:

{% tabs %}
{% tab title="GraphQL" %}

```graphql
mutation customerCreate($input: CustomerCreateInput!) {
  customerCreate(input: $input) {
    customer {
      id
      firstName
      lastName
      phone
      email
      taxId {
        value
        type
      }
    }
    userErrors {
      field
      message
    }
  }
}
```

{% endtab %}

{% tab title="GraphQL Query Variables" %}

```javascript
{
  "input": {
    "email": "john@example.com",
    "firstName": "John",
    "lastName": "Doe",
    "phone": "52155762343",
    "taxId": {
      "value": "1271823961",
      "type": "MX_RFC"
    }
  }
}
```

{% endtab %}
{% endtabs %}

```javascript
{
  "data": {
    "customerCreate": {
      "customer": {
        "id": "gid://kublau/Customer/0722d839-52b4-4aa1-bb97-0f6c9fdf2cca",
        "firstName": "John",
        "lastName": "Doe",
        "phone": "52155762343",
        "email": "john@example.com",
        "taxId": {
          "value": "1271823961",
          "type": "MX_RFC"
        }
      },
      "userErrors": []
    }
  }
}
```

## **Creating an order**

An **order** connects a **Tracker** or **Shipment** with the customer they belong to. It also allows you to store additional information such as a unique identifier, tags (coming soon) or custom attributes (coming soon).

Here is an example of how to create an order:

{% tabs %}
{% tab title="GraphQL" %}

```graphql
mutation orderCreate($input: OrderCreateInput!) {
  orderCreate(input: $input) {
    order {
      id
      externalId 
      customer {
        id
        firstName
        lastName
        email
        phone
      }
    }
    userErrors {
      field
      message
    }
  }
}
```

{% endtab %}

{% tab title="GraphQL Query Variables" %}

```javascript
{
  "input": {
    "customerId": "gid://kublau/Customer/0722d839-52b4-4aa1-bb97-0f6c9fdf2cca",
    "externalId": "#1003"
  }
}
```

{% endtab %}
{% endtabs %}

```javascript
{
  "data": {
    "orderCreate": {
      "order": {
        "id": "gid://kublau/Order/09e00093-5cc8-4a7a-bb52-b94179a7a6fd",
        "externalId": "#1003",
        "customer": {
          "id": "gid://kublau/Customer/0722d839-52b4-4aa1-bb97-0f6c9fdf2cca",
          "firstName": "John",
          "lastName": "Doe",
          "email": "john@example.com",
          "phone": "52155762343"
        }
      },
      "userErrors": []
    }
  }
}
```

### Passing custom data to the Order with metafields

Metafields enable you to save specialized information that isn't usually captured by standard Kublau resources. You can use Metafields for internal tracking, custom flows inside Kublau or to display specialized information on your emails and tracking pages in a variety of ways.

Here is an example of how to include a text **my\_custom\_text\_field** field and an integer **my\_custom\_integer\_field** integer field when creating an order:

{% tabs %}
{% tab title="GraphQL" %}

```graphql
mutation orderCreate($input: OrderCreateInput!) {
  orderCreate(input: $input) {
    order {
      id
      metafields {
        key
        value
        valueType
      }
    }
    userErrors {
      field
      message
    }
  }
}
```

{% endtab %}

{% tab title="GraphQL Query Variables" %}

```javascript
{
  "input": {
    ...
    "metafields": [
      {
      	"key": "my_custom_text_field",
      	"value": "This is a custom text field"
      },
      {
        "key": "my_custom_integer_field",
        "value": "6"
      }
    ]
  }
}
```

{% endtab %}
{% endtabs %}

```javascript
{
  "data": {
    "orderCreate": {
      "order": {
        "id": "gid://kublau/Order/09e00093-5cc8-4a7a-bb52-b94179a7a6fd",
         "metafields": [
          {
            "key": "my_custom_text_field",
            "value": "This is a custom text field",
            "valueType": "STRING"
          },
          {
            "key": "my_custom_integer_field",
            "value": "6",
            "valueType": "INTEGER"
          }
        ]
      },
      "userErrors": []
    }
  }
}
```

You can read more on [how to add your own custom metafields here](/kublau-docs/guides/including-order-and-customer-data/resource-metafields.md).

## **Adding product information to the order**

**Products** define what you are shipping in Kublau’s API and allow you to improve and customize notifications. It also serves as valuable reference information for a tracker or shipment.

Here is an example of how to specify which product you are shipping while creating an order:

{% tabs %}
{% tab title="GraphQL" %}

```graphql
mutation orderCreate($input: OrderCreateInput!) {
  orderCreate(input: $input) {
    order {
      id
    }
    userErrors {
      field
      message
    }
  }
}
```

{% endtab %}

{% tab title="GraphQL Query Variables" %}

```javascript
{
  "input": {
    "customerId": "gid://kublau/Customer/0722d839-52b4-4aa1-bb97-0f6c9fdf2cca",
    "externalId": "#1003",
     "lineItems": [
      {
        "quantity": 1,
        "sku": "PRODUCT_SKU"
      }
    ]
  }
}
```

{% endtab %}
{% endtabs %}

```javascript
{
  "data": {
    "orderCreate": {
      "order": {
        "id": "gid://kublau/Order/09e00093-5cc8-4a7a-bb52-b94179a7a6fd"
      },
      "userErrors": []
    }
  }
}
```

## **Adding address information to the order**

An **order** has a`shippingAddress` field which represents the address this order is being shipped to. If you generate the label with our API we will automatically use the destination address of your shipment when [referencing an order when creating a tracker](/kublau-docs/guides/including-order-and-customer-data.md#referencing-the-order-on-a-tracker-or-shipment).

{% tabs %}
{% tab title="GraphQL" %}

```graphql
mutation orderCreate($input: OrderCreateInput!) {
  orderCreate(input: $input) {
    order {
      id
      shippingAddress {
        line1
        line1
        city
        state
        postalCode
        country
      }
    }
    userErrors {
      field
      message
    }
  }
}
```

{% endtab %}

{% tab title="GraphQL Query Variables" %}

```javascript
{
  "input": {
    "customerId": "gid://kublau/Customer/0722d839-52b4-4aa1-bb97-0f6c9fdf2cca",
    "externalId": "#1003"
    "shippingAddress": {
      "line1": "417 MONTGOMERY ST",
      "city": "SAN FRANCISCO",
      "state": "CA",
      "postalCode": "94105",
      "country":"US",
      "name": "John Doe",
      "phone": "123 456 789 15"
    }
  }
}
```

{% endtab %}
{% endtabs %}

```javascript
{
  "data": {
    "orderCreate": {
      "order": {
        "id": "gid://kublau/Order/09e00093-5cc8-4a7a-bb52-b94179a7a6fd",
        "externalId": "#1003",
        "shippingAddress": {
          "line1": "417 MONTGOMERY ST",
          "city": "SAN FRANCISCO",
          "state": "CA",
          "postalCode": "94105",
          "country":"US",
          "name": "John Doe",
          "phone": "123 456 789 15"
        }
      },
      "userErrors": []
    }
  }
}
```

## **Referencing the order on a Tracker or Shipment**

When creating a Tracker (`trackerCreate`) or Shipment (`shipmentCreate`)  include the **`orderId`** argument with the id of the order you created.

Here is an example of GraphQL Query Variables that include an  **`orderId`** :

{% tabs %}
{% tab title="trackerCreate" %}

```javascript
{
  "input": {
    "orderId": "gid://kublau/Order/b177e171-f288-4bb5-bf94-73807d5053f2",
    "trackingCode": "837323020",
    "carrier": "ESTAFETA"
  }
}
```

{% endtab %}

{% tab title="shipmentCreate" %}

```javascript
{
    "input": {
        "orderId": "gid://kublau/Order/b177e171-f288-4bb5-bf94-73807d5053f2",
        "origin": {
            "line1": "417 MONTGOMERY ST",
            "city": "SAN FRANCISCO",
            "state": "CA",
            "postalCode": "94105",
            "country":"US",
            "name": "John Doe",
            "phone": "123 456 789 15"
        },
        "destination": {
            "line1": "532 Folsom St. 5",
            "line2": "Apartment 654",
            "city": "SAN FRANCISCO",
            "state": "CA",
            "postalCode": "94105",
            "country": "US",
            "name": "John Doe",
            "phone": "123 456 789 16"
        },
        "parcel":{
            "length": 20.0,
            "width": 20.0,
            "height": 20.0,
            "weight": 29.0
        }
    }
}
```

{% endtab %}
{% endtabs %}

That’s it! Your are including order and customer data with your shipments and trackers.


---

# 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.kublau.com/kublau-docs/guides/including-order-and-customer-data.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.