> For the complete documentation index, see [llms.txt](https://help.citrusad.com/retail-media-interface/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.citrusad.com/retail-media-interface/integration/es/data-api/customer-data/syncing-customer-data-via-api-1.md).

# Sincronizar datos de clientes mediante API

## Envío de datos de clientes a Epsilon Retail Media

Para enviar datos de clientes a Epsilon Retail Media, utiliza un comando similar al siguiente. Ten en cuenta que los datos en el `customers` campo son datos ficticios y se proporcionan aquí solo como ejemplo.

{% hint style="info" %}
Todos los `customer` campos del objeto son opcionales. Si envías un `customer` objeto sin ningún valor en los campos, se creará un nuevo `id` por lo que no especifiques un `id` si estás creando `customer` objetos.

Todos los valores en el `targetingData` campo son arbitrarios y configurables por el minorista. Consulta la página de referencia para obtener más información.
{% endhint %}

```http
POST $BASE_URL/v1/customers HTTP/1.1
accept: application/json
content-type: application/json
Authorization: Basic <API_KEY>
{
    "customers": [
        {
            "id": "i4358f9b-bbb9-49fb-93fe-3ad481ce564",
            "targetingData": {
            "customer_type": "Corporate"
            }
        }
    ]
}
```

Si se realiza correctamente, se devolverá el siguiente objeto:

```json
{
    "customers": [
        {
            "targetingData": {
                "customer_type": "Corporate"
            },
            "gender": "Other",
            "teamId": "9be784a8-22fc-4315-a335-b7d2c2494f0a",
            "postcode": "",
            "suburb": "",
            "id": "i4358f9b-bbb9-49fb-93fe-3ad481ce564",
            "yearOfBirth": 0
        }
    ]
}
```

## Sincronización de varios clientes

Si estás sincronizando varios clientes, puedes enviar hasta 100 elementos como un lote con cada solicitud. El número de solicitudes que puedes hacer es ilimitado.

El orden de la carga útil del cliente enviada es el mismo orden que el resultado devuelto, lo que permite que los datos sigan siendo congruentes con la representación del cliente que el integrador mantiene en su backend.

```http
POST $BASE_URL/v1/customers HTTP/1.1
accept: application/json
content-type: application/json
Authorization: Basic <API_KEY>
{
    "customers": [
        {
            "id": "i4358f9b-bbb9-49fb-93fe-3ad481ce564",
            "targetingData": {
            "customer_type": "Corporate"
            }
        },
        {
            "id": "c7792468-07ea-4cc3-9b1a-975bb43dfa02",
            "targetingData": {
            "customer_type": "Retail"
            }
        }
    ]
}
```

Si se realiza correctamente, se devolverá el siguiente objeto:

```json
{
    "customers": [
        {
            "targetingData": {
                "customer_type": "Corporate"
            },
            "gender": "Other",
            "teamId": "9be784a8-22fc-4315-a335-b7d2c2494f0a",
            "postcode": "",
            "suburb": "",
            "id": "i4358f9b-bbb9-49fb-93fe-3ad481ce564",
            "yearOfBirth": 0
        },
        {
            "targetingData": {
                "customer_type": "Retail"
            },
            "gender": "Other",
            "teamId": "9be784a8-22fc-4315-a335-b7d2c2494f0a",
            "postcode": "",
            "suburb": "",
            "id": "c7792468-07ea-4cc3-9b1a-975bb43dfa02",
            "yearOfBirth": 0
        }
    ]
}
```

{% hint style="warning" %}
`gender`,`postcode`,`suburb`,`yearOfBirth` campos

Ten en cuenta que estos campos ya no se utilizan y solo se conservan para integraciones históricas.
{% endhint %}

### Ingesta masiva de datos de clientes

Al realizar la integración, recomendamos que envíes tu primer lote de datos de clientes como un archivo para su ingesta, ya que la API acepta lotes de 100 a la vez.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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, and the optional `goal` query parameter:

```
GET https://help.citrusad.com/retail-media-interface/integration/es/data-api/customer-data/syncing-customer-data-via-api-1.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.