Saltar al contenido principal

API - Ecommerce - Clientes

Team DataCrush

Agregar o modificar Clientes

Endpoint

Método: POST
URL: http://api.datacrush.la/ecommerce/v1/customer/add


Parámetros de consulta

Parámetro Tipo Descripción
portal_id integer Identificador único del portal. Requerido.
api_key string Clave de autenticación de la API. Requerido.


Cuerpo de la solicitud

La solicitud debe enviarse en formato JSON y debe contener un array de objetos de cliente.

Estructura del JSON (ejemplo)

[
  {
    "id": 1,
    "email": "user@mail.com",
    "first_name": "Juan",
    "last_name": "Martinez",
    "created_at": "2025-01-01",
    "street": "Libertador",
    "street_number": "123",
    "floor": "1",
    "city": "Olivos",
    "state": "Buenos Aires",
    "zip_code": "1234",
    "country": "Argentina"
  }]


Campos del cuerpo de la solicitud

Campo Tipo Descripción
id integer Identificador único del cliente. Obligatorio.
email string Correo electrónico del cliente. Obligatorio.
first_name string Nombre del cliente. Obligatorio.
last_name string Apellido del cliente. Obligatorio.
created_at string Fecha de creación del cliente en formato YYYY-MM-DD.
street string Nombre de la calle del cliente.
street_number string Número de la calle.
floor string Piso del domicilio.
city string Ciudad de residencia del cliente.
state string Provincia o estado del cliente.
zip_code string Código postal del cliente.
country string País de residencia del cliente.


Respuesta

Respuesta exitosa

  • Ejemplo de respuesta:
{"result":"success"}


Respuestas de error

Los errores se devuelven en el siguiente formato:

{
  "result": "fail",
  "error": {
    "code": 210,
    "message": "Error al decodificar JSON"
  },
  "error_list": []
}
Código interno Mensaje de error Descripción
210 "Error al decodificar JSON" El formato del JSON enviado es inválido.
401 "No autorizado" Falta la clave de la API o es incorrecta.
403 "Acceso denegado" El usuario no tiene permisos para esta operación.
500 "Error interno del servidor" Ocurrió un error inesperado en el servidor.


Notas

  • La clave api_key es obligatoria para la autenticación.
  • Si el id del cliente ya existe, se actualizarán sus datos.
  • Solo los campos id, first_name, last_name y email son obligatorios.
  • Para evitar errores de código 210, asegúrate de enviar el JSON con la estructura correcta.

Relacionada con

Artículos relacionados

Comentarios

0 comentarios

El artículo está cerrado para comentarios.