Clientes

Clientes - Actualización

PUT/suite/erp/clientes/:tkCliente

Actualiza la información comercial, fiscal, de contacto y los campos personalizados de un cliente. Solo se modifican los valores enviados.

Parámetros

Nombre	Tipo	Descripción
`tkCliente`	varchar	Identificador del cliente que se actualiza.
`tkEmpresa`	varchar	Identificador alternativo del cliente cuando se integra con un flujo existente.
`tkCrs`	varchar	Identificador alternativo de la razón social que se actualiza.
`tkRazonSocial`	varchar	Identificador de la razón social que se actualiza.
`empresa`	varchar	Nombre comercial del cliente.
`tkIndustria`	varchar	Identificador de la industria asociada.
`tkCorporativo`	varchar	Identificador del corporativo asociado.
`url`	varchar	Sitio web del cliente.
`telefonoCorporativo`	varchar	Teléfono corporativo. Si se omite, se usa `telefono` cuando esté disponible.
`telefono`	varchar	Teléfono alternativo del cliente.
`direccion1`	varchar	Primera línea del domicilio comercial. Si se omite, se usa `calle` cuando esté disponible.
`direccion2`	varchar	Segunda línea del domicilio comercial. Si se omite, se usa `colonia` cuando esté disponible.
`calle`	varchar	Calle del domicilio comercial.
`colonia`	varchar	Colonia del domicilio comercial.
`ciudad`	varchar	Ciudad del domicilio comercial.
`idPais`	varchar	Código de país del domicilio comercial.
`idEstado`	varchar	Código de estado del domicilio comercial.
`idMunicipio`	varchar	Código de municipio del domicilio comercial.
`codigoPostal`	varchar	Código postal del domicilio comercial.
`numeroInterior`	varchar	Número interior del domicilio comercial.
`numeroExterior`	varchar	Número exterior del domicilio comercial.
`idExterno`	varchar	Identificador del cliente en un sistema externo.
`numeroEmpleados`	int	Número de empleados del cliente.
`razonSocial`	varchar	Nombre fiscal que se actualiza.
`rfc`	varchar	RFC que se actualiza.
`registroFiscal`	varchar	Registro fiscal adicional, si aplica.
`idUsoCfdi`	int	Código de uso de CFDI.
`idRegimen`	int	Código de régimen fiscal receptor.
`idPaisRazonSocial`	varchar	Código de país del domicilio fiscal.
`codigoPostalRazonSocial`	varchar	Código postal del domicilio fiscal.
`datosContacto`	int	Usa `1` para crear un contacto principal cuando no exista.
`nombreContacto`	varchar	Nombre del contacto principal.
`apellidosContacto`	varchar	Apellidos del contacto principal.
`telefonoContacto`	varchar	Teléfono del contacto principal.
`correoContacto`	varchar	Correo del contacto principal.
`calleContacto`	varchar	Calle del domicilio del contacto.
`coloniaContacto`	varchar	Colonia del domicilio del contacto.
`ciudadContacto`	varchar	Ciudad del domicilio del contacto.
`idPaisContacto`	varchar	Código de país del contacto.
`idEstadoContacto`	varchar	Código de estado del contacto.
`cp`	varchar	Valores de campos personalizados del cliente en formato JSON.

Respuesta

Nombre	Tipo	Descripción
`code`	Integer	Código del resultado. Es `0` cuando el cliente se actualiza correctamente.
`msg`	String	Mensaje que describe el resultado de la operación.

Solicitud

curl --request PUT \
  --url 'https://api.upnify.com/suite/erp/clientes/00000000-0000-4000-8000-000000000010' \
  --header 'Content-Type: application/json' \
  --header 'token: 00000000-0000-4000-8000-000000000001' \
  --data '{"empresa":"Empresa Ejemplo Actualizada, S.A. de C.V.","telefonoCorporativo":"5550102030"}'const datos = { empresa: "Empresa Ejemplo Actualizada, S.A. de C.V.", telefonoCorporativo: "5550102030" };
fetch("https://api.upnify.com/suite/erp/clientes/00000000-0000-4000-8000-000000000010", { method: "PUT", headers: { "Content-Type": "application/json", token: "00000000-0000-4000-8000-000000000001" }, body: JSON.stringify(datos) }).then((respuesta) => respuesta.json()).then(console.log);// Node.js 18 o posterior
const datos = { empresa: "Empresa Ejemplo Actualizada, S.A. de C.V.", telefonoCorporativo: "5550102030" };
fetch("https://api.upnify.com/suite/erp/clientes/00000000-0000-4000-8000-000000000010", { method: "PUT", headers: { "Content-Type": "application/json", token: "00000000-0000-4000-8000-000000000001" }, body: JSON.stringify(datos) }).then((respuesta) => respuesta.json()).then(console.log);import requests

datos = {"empresa": "Empresa Ejemplo Actualizada, S.A. de C.V.", "telefonoCorporativo": "5550102030"}
respuesta = requests.put("https://api.upnify.com/suite/erp/clientes/00000000-0000-4000-8000-000000000010", headers={"token": "00000000-0000-4000-8000-000000000001"}, json=datos)
respuesta.raise_for_status()
print(respuesta.json())package main

import (
  "bytes"
  "encoding/json"
  "net/http"
)

func main() {
  datos := []byte(`{"empresa":"Empresa Ejemplo Actualizada, S.A. de C.V.","telefonoCorporativo":"5550102030"}`)
  solicitud, err := http.NewRequest(http.MethodPut, "https://api.upnify.com/suite/erp/clientes/00000000-0000-4000-8000-000000000010", bytes.NewReader(datos))
  if err != nil { panic(err) }
  solicitud.Header.Set("Content-Type", "application/json")
  solicitud.Header.Set("token", "00000000-0000-4000-8000-000000000001")
  respuesta, err := http.DefaultClient.Do(solicitud)
  if err != nil { panic(err) }
  defer respuesta.Body.Close()
  var resultado any
  if err := json.NewDecoder(respuesta.Body).Decode(&resultado); err != nil { panic(err) }
}using System.Net.Http;
using System.Net.Http.Json;

using var cliente = new HttpClient();
cliente.DefaultRequestHeaders.Add("token", "00000000-0000-4000-8000-000000000001");
var datos = new { empresa = "Empresa Ejemplo Actualizada, S.A. de C.V.", telefonoCorporativo = "5550102030" };
using var respuesta = await cliente.PutAsJsonAsync("https://api.upnify.com/suite/erp/clientes/00000000-0000-4000-8000-000000000010", datos);
respuesta.EnsureSuccessStatusCode();
var resultado = await respuesta.Content.ReadFromJsonAsync<object>();

Respuesta

[
  {
    "code": 0,
    "msg": "Ok"
  }
]

Clientes - Actualización

Parámetros

Respuesta

Solicitud

Actualizar un cliente

Respuesta

Cliente actualizado