Guardar Clientes

Para guardar los clientes en Nuwwe, cuentas con las URL:

https://api.nuwwe.com/api/cliente/store

Guardar

PUT https://api.nuwwe.com/api/cliente/store

Request Body

Name	Type	Required	Description
obs_cliente	string	NO	(Max 2000) Observación del cliente
dir_envio_correspondencia	string	NO	(Max 500) Dirección donde se enviara la correspondencia se debe enviar en este formato JSON: {"dir": "Avenida Carrera-AK 87a ESTE 40c 90 SUR","json": "{\"atipico\":\"Avenida Carrera-AK 87a ESTE 40c 90 SUR\"}"} Enviar en string, aquí un ejemplo de PHP <?php // Definir el array interno para el campo "json" $json_interno = [ "atipico" => "Avenida Carrera-AK 87a ESTE 40c 90 SUR" ]; // Construir el campo "dir_cliente" $dir_cliente = [ "dir" => "Avenida Carrera-AK 87a ESTE 40c 90 SUR", "json" => json_encode($json_interno) // Escapamos correctamente el JSON interno ]; // Convertir todo a un string JSON válido $dir_cliente_string = json_encode($dir_cliente, JSON_UNESCAPED_UNICODE); // Mostrar el resultado echo $dir_cliente_string; Nota: Este es solo un ejemplo, ya que puede variar según el lenguaje de programación que se esté utilizando.
tel_cliente	string	NO	(Max 400) Numero de teléfono del cliente, se debe enviar en este formato JSON: [{"id":"TE1","value":"4566455"},{"id":"TE2","value":"4888888888","obs":""},{"id":"TE3","value":"3055555555444","obs":""}] TE1 = Teléfono fijo TE2 = Celular TE3 = Teléfono internacional
dir_cliente	string	NO	(Max 500) Dirección del cliente, se debe enviar en este formato JSON: {"dir": "Avenida Carrera-AK 87a ESTE 40c 90 SUR","json": "{\"atipico\":\"Avenida Carrera-AK 87a ESTE 40c 90 SUR\"}"} Enviar en string, aquí un ejemplo de PHP <?php // Definir el array interno para el campo "json" $json_interno = [ "atipico" => "Avenida Carrera-AK 87a ESTE 40c 90 SUR" ]; // Construir el campo "dir_cliente" $dir_cliente = [ "dir" => "Avenida Carrera-AK 87a ESTE 40c 90 SUR", "json" => json_encode($json_interno) // Escapamos correctamente el JSON interno ]; // Convertir todo a un string JSON válido $dir_cliente_string = json_encode($dir_cliente, JSON_UNESCAPED_UNICODE); // Mostrar el resultado echo $dir_cliente_string; Nota: Este es solo un ejemplo, ya que puede variar según el lenguaje de programación que se esté utilizando.
cod_cliente	string	SI	(Max 20) Numero de cedula de ciudadanía
agente_retenedor	string	SI	(Max 1) Campo S / N
cod_barrio_cliente	string	NO	(Max 5) Se obtiene de la paramétrica barrio
cod_barrio_correspondencia	string	NO	(Max 5) Se obtiene de la paramétrica barrio
cod_ciudad_cliente	string	SI	(Max 5) Se obtiene de la paramétrica ciudad
cod_ciudad_documento	string	SI	(Max 5) Se obtiene de la paramétrica ciudad
cod_tipo_cliente	string	SI	(Max 3) Se obtiene de la paramétrica tipo cliente
cod_tipo_documento	string	SI	(Max 3) Se obtiene de la paramétrica tipo documento
cod_tipo_regimen	string	SI	(Max 3) Se obtiene de la paramétrica tipo régimen
declara_renta	string	SI	(Max 1) Campo S / N
email	string	NO	(Max 6) Correo electrónico del cliente
primer_apellido	string	NO	(Max 30) Primer apellido del cliente
primer_nombre	string	SI	(Max 200) Primer nombre del cliente
segundo_apellido	string	NO	(Max 30) Segundo apellido del cliente
segundo_nombre	string	NO	(Max 50) Segundo nombre
responsable_iva	string	SI	(Max 1) Campo S / N
retiene_sobre_iva	string	SI	(Max 1) Campo S / N
sexo	string	SI	(Max 1) Array M = Masculino, F = Femenino, E = Empresa
tipo_envio_correspondencia	string	NO	(Max 3) Se obtiene de la paramétrica tipo envió correspondencia

200

{
  "success": true,
  "code": 200,
  "msg": "Exito",
  "datos": {
    "cod_cliente": "99999999123",
    "nom_ciudad_documento": "SOGAMOSO",
    "primer_nombre": "JUAN",
    "segundo_nombre": "HERNAN",
    "primer_apellido": "BAUTISTA",
    "segundo_apellido": "MANTILLA",
    "cod_tipo_regimen": "RC",
    "nom_tipo_regimen": "REGIMEN COMUN",
    "cod_tipo_cliente": "PN",
    "nom_tipo_cliente": "PERSONA NATURAL",
    "cod_tipo_documento": "31",
    "nom_tipo_documento": "NIT",
    "sexo": "M",
    "dir_cliente": null,
    "tel_cliente": null,
    "cod_ciudad_cliente": "68276",
    "nom_ciudad": "FLORIDABLANCA",
    "email": "[e-mail]",
    "responsable_iva": "S",
    "agente_retenedor": "N",
    "retiene_sobre_iva": "N",
    "obs_cliente": null,
    "declara_renta": "N",
    "dir_envio_correspondencia": null,
    "cod_ciudad_documento": "15759",
    "tipo_envio_correspondencia": "EMA",
    "dir_cliente_consulta": null,
    "dir_envio_corres_consulta": null,
    "tel_cliente_consulta": null,
    "cod_barrio_cliente": "208",
    "nom_barrio_cliente": "LAGOS II",
    "cod_barrio_correspondencia": "208",
    "nom_barrio_correspondencia": "LAGOS II"
  }
}

422

{
  "success": false,
  "code": 422,
  "state": "Error de validación",
  "message": {
    "cod_cliente": [
      "El campo cod cliente es obligatorio."
    ]
  },
  "data": []
}

Crear Array para el campo Sexo

ID	VALUE
M	Masculino
F	Femenino
E	Empresa

Guardar la foto de un cliente

Para guardar la foto de un cliente existen dos maneras: 1. En el JSON de envió colocar un nuevo campo "imagen_foto": " " ( Donde el valor es una imagen Base64).

2. En cliente documento podemos subir la foto del cliente, en los parámetros que vamos a enviar cod_clase_documento colocaremos como valor "FOT" y en ruta_archivo enviaremos la foto como tipo file. https://nuwwe-api.gitbook.io/api-nuwwe-1/cliente-documento/guardar-cliente-documento