SiigoAPI
Siigo API

Actualizar Cliente

Esta funcionalidad te permite actualizar un tercero, debe enviar igual los campos como en su creación porque remplaza los datos. Si hay un campo vacio quedara vacio en Nube.

NombreTipoDescripciónCaracterísticas
typestringCampo para identificar el tipo de cliente.Campo opcional, con 3 tipos "Customer, Supplier, Other", si no se envia por defecto toma el tipo "Customer".
person_typestringIdentifica si el tercero es moral, physical o foreign.Campo obligatorio, solo se puede enviar "moral, physical o foreign".
rfc_idstringRFC de identificación del cliente.Campo obligatorio, debe cumplir con las siguientes expresiones regulares según el tipo de persona: Moral: ('^([A-ZÑa-zñ&]3[0-9]6[A-ZÑa-zñ0-9]3)$'), Physical: ('^([A-ZÑa-zñ&]4[0-9]6[A-ZÑa-zñ0-9]3)$').
namestringRazón social o nombres y apellidos del cliente.Campo obligatorio, no permite carácteres especiales, Company es un solo campo, en el array de Person son 2 campos, tiene un máximo 100 carácteres por campo "string".
commercial_namestringNombre comercial o Nombre comercial de la empresa del cliente.Campo opcional, alfanúmerico, permite espacios y carácteres especiales.
branch_officenumberSucursal, valor por default 0.Campo opcional, solo recibe números enteros del 0 al 999.
fiscal_regimestringRégimen fiscal del tercero.Campo opcional, consulte el listado de códigos válidos por el SAT para cada tipo de persona aquí.
activebooleanEstado del cliente en Siigo.Campo opcional, si no se envia el valor por default es "true".
address.addressstringDirección del cliente.Campo obligatorio, alfanúmerico, permite espacios, máximo 256 carácteres.
address.interior_numberstringNúmero de interior del cliente.Alfanumérico máximo 20 caracteres, permite espacios intermedios, permite caracteres especiales, puede estar vacío, puede existir previamente otro tercero con el mismo interior_number.
address.exterior_numberstringNúmero de exterior del cliente.Alfanumérico máximo 20 caracteres, permite espacios intermedios, permite caracteres especiales, puede estar vacío, puede existir previamente otro tercero con el mismo exterior_number.
address.colonystringColonía de la dirección del cliente.Alfanumérico máximo 20 caracteres, permite espacios intermedios, permite caracteres especiales, puede estar vacío, puede existir previamente otro tercero con la misma colony.
address.localitystringLocalidad de la dirección del cliente.Alfanumérico máximo 20 caracteres, permite espacios intermedios, permite caracteres especiales, puede estar vacío, puede existir previamente otro tercero con la misma locality.
address.city.country_codestringCódigo del país.Puedes descargar el listado de códigos aquí o consultar en Siigo Nube por la ruta de: Reportes de configuración - Localidad - Países, estados y ciudades / municipios.
address.city.state_codestringCódigo del departamento/estado.Puedes descargar el listado de códigos aquí o consultar en Siigo Nube por la ruta de: Reportes de configuración - Localidad - Países, estados y ciudades / municipios.
address.city.city_codestringCódigo de la ciudad.Puedes descargar el listado de códigos aquí o consultar en Siigo Nube por la ruta de: Reportes de configuración - Localidad - Países, estados y ciudades / municipios.
address.postal_codestringCódigo postal.Campo opcional, alfanúmerico, no permite espacios, máximo 5 carácteres.
phones.indicativestringIndicativo del número de contacto.Campo opcional, númerico, no permite espacios ni carácteres especiales, máximo 10 carácteres.
phones.numberstringNúmero de contacto.Campo opcional, númerico, no permite espacios ni carácteres especiales, máximo 10 carácteres.
phones.extensionstringExtensión del número de contacto.Campo opcional, númerico, no permite espacios ni carácteres especiales, máximo 10 carácteres.
contacts.first_namestringNombres del contacto.Campo obligatorio, permite espacios y carácteres especiales, alfanpumerico, máximo 50 carácteres.
contacts.last_namestringApellidos del contacto.Campo opcional, permite espacios y carácteres especiales, alfanpumerico, máximo 50 carácteres.
contacts.emailstringCorreo del contacto.Campo opcional, NO permite espacios ni carácteres especiales, alfanpumerico, máximo 100 carácteres.
contacts.phone.indicativestringIndicativo del número del contacto.Campo opcional, númerico, no permite espacios ni carácteres especiales, máximo 10 carácteres.
contacts.phone.numberstringNúmero del contacto.Campo opcional, númerico, no permite espacios ni carácteres especiales, máximo 10 carácteres.
contacts.phone.extensionstringExtensión del número del contacto.Campo opcional, númerico, no permite espacios ni carácteres especiales, máximo 10 carácteres.
commentsstringObservaciones o comentarios adicionales.Campo opcional, alfanúmerico, permite espacios y carácteres especiales, máximo 4000 carácteres.
seller_idnumberUsuario vendedor asigando al cliente.Campo opcional, númerico, el id del usuario debe existir previamente en Siigo Nube, se puede consultar con una petición tipo GET al endpoint de https://api.siigo.mx/v1/users.
collector_idnumberUsuario cobrador encargado del recaudo de cartera.Campo opcional, númerico, el id del usuario debe existir previamente en Siigo Nube, se puede consultar con una petición tipo GET al endpoint de https://api.siigo.mx/v1/users.
PUT
/v1/customers/{id}

Authorization

application/json<token>

In: header

Authorization<token>

[access_token]

In: header

SiigoAPI-Application-Id<token>

nombre de la aplicación que estás integrando

In: header

Request Body

application/jsonOptional

Representa la solicitud con la información actualizada del cliente.

typestring

Campo para identificar el tipo de cliente.

Default: "Customer"Value in: "Customer" | "Supplier" | "Other"
person_type
Required
string

Identifica si el tercero es moral, physical o foreign.

Value in: "moral" | "physical" | "foreign"
rfc_id
Required
string

RFC de identificación del cliente.

Maximum length: 13
name
Required
string

Razón social o nombres y apellidos del cliente.

Maximum length: 100
commercial_namestring

Nombre comercial o Nombre comercial de la empresa del cliente.

Maximum length: 100
branch_officeinteger

Sucursal, valor por default 0.

Default: 0Minimum: 0Maximum: 999
fiscal_regimestring

Régimen fiscal del tercero.

activeboolean

Estado del cliente en Siigo.

Default: true
address
Required
object
phonesobject
contactsobject
commentsstring

Observaciones o comentarios adicionales.

Maximum length: 4000
seller_idinteger

Usuario vendedor asigando al cliente.

collector_idinteger

Usuario cobrador encargado del recaudo de cartera.

Path Parameters

id
Required
string

Identificador único del cliente a actualizar.

Format: "uuid"
curl -X PUT "https://api.siigo.mx/v1/customers/497f6eca-6276-4993-bfeb-53cbbbba6f08" \
  -H "application/json: <token>" \
  -H "Authorization: <token>" \
  -H "SiigoAPI-Application-Id: <token>" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "Customer",
    "person_type": "moral",
    "rfc_id": "ABC123456789",
    "name": "Empresa Actualizada S.A. de C.V.",
    "commercial_name": "Empresa Actualizada",
    "branch_office": 1,
    "fiscal_regime": "601",
    "active": true,
    "address": {
      "address": "Av. Actualizada 456",
      "interior_number": "B",
      "exterior_number": "456",
      "colony": "Nuevo Centro",
      "locality": "Nueva Ciudad",
      "city": {
        "country_code": "MX",
        "state_code": "09",
        "city_code": "09002"
      },
      "postal_code": "54321"
    },
    "phones": {
      "indicative": "52",
      "number": "5598765432",
      "extension": "456"
    },
    "contacts": {
      "first_name": "María",
      "last_name": "García",
      "email": "[email protected]",
      "phone": {
        "indicative": "52",
        "number": "5598765432",
        "extension": "456"
      }
    },
    "comments": "Cliente actualizado",
    "seller_id": 789,
    "collector_id": 101
  }'

Cliente actualizado exitosamente

{
  "id": "63f918c2-ca65-4edc-a7db-66bcdd5159fb",
  "type": "Customer",
  "person_type": "moral",
  "rfc_id": "ABC123456789",
  "name": "Empresa Actualizada S.A. de C.V.",
  "commercial_name": "Empresa Actualizada",
  "branch_office": 1,
  "fiscal_regime": "601",
  "active": true,
  "address": {
    "address": "Av. Actualizada 456",
    "interior_number": "B",
    "exterior_number": "456",
    "colony": "Nuevo Centro",
    "locality": "Nueva Ciudad",
    "city": {
      "country_code": "MX",
      "state_code": "09",
      "city_code": "09002"
    },
    "postal_code": "54321"
  },
  "phones": {
    "indicative": "52",
    "number": "5598765432",
    "extension": "456"
  },
  "contacts": {
    "first_name": "María",
    "last_name": "García",
    "email": "[email protected]",
    "phone": {
      "indicative": "52",
      "number": "5598765432",
      "extension": "456"
    }
  },
  "comments": "Cliente actualizado",
  "seller_id": 789,
  "collector_id": 101,
  "metadata": {
    "created": "2024-01-15T10:30:00Z",
    "last_updated": "2024-01-16T14:45:00Z"
  }
}