Desarrollador
Contactos
CRUD de contactos comerciales. El rol va en types.
Un contacto no tiene portal. El cuerpo es ContactWrite. types sale de CONTACT_TYPES: SHIPPER, CONSIGNEE, CARRIER, FORWARDER, NOTIFY_PARTY, BROKER, IMPORTER, EXPORTER, AGENT, WAREHOUSE. Si se omite, queda SHIPPER. CLIENT no es válido. clientId lo vincula a un cliente. En un update, clientId null lo desvincula y types reemplaza los roles.
Métodos
| Método | HTTP | Scope |
|---|---|---|
| contacts.list() | GET /org-api/v1/contacts | contacts:read o organization:read |
| contacts.retrieve(id) | GET /org-api/v1/contacts/:id | contacts:read o organization:read |
| contacts.create(body) | POST /org-api/v1/contacts | contacts:write o organization:read |
| contacts.update(id, body) | PATCH /org-api/v1/contacts/:id | contacts:write o organization:read |
| contacts.delete(id) | DELETE /org-api/v1/contacts/:id | contacts:write o organization:read |
const contact = await traky.contacts.create({
firstName: "Luis",
types: ["SHIPPER"],
clientId: customer.id,
});
await traky.contacts.update(contact.id, {
types: ["SHIPPER", "CONSIGNEE"],
});
await traky.contacts.delete(contact.id);Listar
const page = await traky.contacts.list({
clientId: customer.id,
types: ["SHIPPER"],
linked: true,
});clientId limita a los contactos de un cliente. linked y unlinked filtran si tienen cliente. El borrado devuelve id y deleted: true.