Clientes y terceros

Solo se graban las columnas de la lista blanca de cada recurso (los campos grabables que aparecen en cada endpoint); cualquier otra clave del JSON se ignora en silencio. Cada valor es un texto, un número, un booleano (se guarda como 1 o 0) o null; un arreglo o un objeto responde 400 FIELD_INVALID: campo. Los componentes de la clave primaria que no se envíen toman el valor ---. El id puede enviarse (máximo 45 caracteres alfanuméricos, _, - y .); si se omite, la API genera un UUID.

Requeridos en POST doi_id doi name

Componentes de la clave — si no se envían toman --- cus_cha_id sll_id cus_grp_id cus_cla_id cus_sec_id cat_id doi_id doi

Campos grabables

Campo	Etiqueta	Tipo	Obl.
cou_id	—	texto
geo_id	—	texto
name	—	texto	•
description	—	texto
name_commercial	—	texto
registered	—	fecha
sic_id	—	texto
cus_cnt_id	—	texto
cus_cnt_name	—	texto
firstname	—	texto
lastname	—	texto
middlename	—	texto
status	—	texto
condition	—	texto
type	—	texto
activity	—	fecha
phone	—	texto
phone_home	—	texto
phone_mobile	—	texto
phone_office	—	texto
phone_fax	—	texto
email	—	texto
state	—	texto
province	—	texto
city	—	texto
zone	—	texto
address	—	texto
billing_address	—	texto
shipping_address	—	texto
importer	—	booleano
exporter	—	booleano
legal_representatives	—	texto
employees	—	número
mar_id	—	texto
edu_id	—	texto
annual_revenue	—	número
agent_detraction	—	booleano
agent_retention	—	booleano
agent_collection	—	booleano
electronic_invoicing	—	fecha
electronic_payroll	—	fecha
system_accounting	—	texto
system_invoicing	—	texto
code	—	texto
prd_prc_id	—	referencia a Listas de Precios
itm_prc_id	—	texto
rating	—	número
score	—	número

Nunca se devuelven pass token

Con formato (se sanean al guardar) description

curl -X POST "https://sandbox.minimarket.digital/v1/customer" \
     -H "X-SYNCS-API-TOKEN: TU_TOKEN" \
     -H "Content-Type: application/json" \
     -d '{
         "doi_id": "rucPE",
         "doi": "20123456786",
         "name": "ACME Distribuciones SAC",
         "name_commercial": "ACME",
         "cus_cla_id": "a",
         "email": "ventas@acme.pe",
         "phone_mobile": "+51987654321",
         "city": "Lima",
         "address": "Av. Javier Prado Este 1234"
     }'

Respuesta

{
    "status": "success",
    "code": "201",
    "message": "ADD",
    "data": {
        "id": "a1b2c3d4-5e6f-7890-abcd-ef1234567890",
        "doi_id": "rucPE",
        "doi": "20123456786",
        "name": "ACME Distribuciones SAC",
        "name_commercial": "ACME",
        "cus_cla_id": "a",
        "email": "ventas@acme.pe",
        "phone_mobile": "+51987654321",
        "city": "Lima",
        "address": "Av. Javier Prado Este 1234"
    }
}