Skip to main content
Skip table of contents

Actualización de direcciones de un cliente

Esta función permite actualizar direcciones de un cliente dado.

Parámetros de Entrada

Parámetro

Tipo

Descripción

clientId CAMPO OBLIGATORIO

Integer

Identificador del cliente

locationId CAMPO OBLIGATORIO

Integer

Identificador de la dirección

additionalData

String

Campo donde se incluyen datos adicionales de la dirección

addressLine1

String

Línea 1 de la dirección.

Este dato es obligatorio, si no tiene valor no se modifica.

addressLine2

String

Línea 2 de la dirección

city

String

Ciudad

countryId

Integer

Identificador del país. Este campo es obligatorio si se especifica el identificador de la provincia (stateId)

Los códigos de país están indicados en el anexo 5.1 Códigos de país de este documento.

county

String

Municipio

locationTypes

List

Tipos de dirección. El parámetro contiene un listado de String con los tipos de dirección. Los posibles valores son:

BI = Facturación, CE = Certificado, SH = Envío

mainLocation

Boolean

Indica si esta dirección es la principal

name

String

Nombre descriptivo de la dirección

stateId

Integer

Identificador de la provincia. Los códigos de las provincias se pueden obtener con una llamada al API (Recuperar provincias de un país).

zipCode

String

Código postal

Parámetros de Salida

Parámetro

Tipo

Descripción

locationId

Integer

Identificador de la dirección

additionalData

String

Campo donde se incluyen datos adicionales de la dirección

addressLine1

String

Línea 1 de la dirección

addressLine2

String

Línea 2 de la dirección

city

String

Ciudad

countryId

Integer

Identificador del país. Los códigos de país están indicados en el anexo 5.1 Códigos de país de este documento.

county

String

Municipio

locationTypes

List

Tipos de dirección. El parámetro contiene un listado de String con los tipos de dirección. Los posibles valores son:

BI = Facturación, CE = Certificado, SH = Envío

mainLocation

Boolean

Indica si esta dirección es la principal

name

String

Nombre descriptivo de la dirección

stateId

Integer

Identificador de la provincia. Los códigos de las provincias se pueden obtener con una llamada al API (Recuperar provincias de un país).

zipCode

String

Código postal

Códigos Error

Código

Descripción

1000

Error genérico

3310

Error actualizando la dirección

3311

El cliente indicado no existe

3312

La dirección indicada no existe

3313

El usuario logado no tiene acceso al cliente indicado

3314

Se ha especificado provincia pero no el país

3315

El código de provincia indicado no es válido

3316

El tipo de localización no es válido

3317

El código del país indicado no es válido

3318

La dirección es la principal y no se puede modificar para que no lo sea. Para modificar una dirección principal, hay que actualizar la dirección que será la principal y automáticamente la que era principal deja de serlo.

Ejemplos

Llamada (Método POST)

JSON
https://servidor:8443/calibry-rest-api/rest/cif/client/{clientId}/location/{locationId}

https://servidor:8443/calibry-rest-api/rest/cif/client/1/location/2


Headers:
    Authorization
    Content-Type = application/json

Body:
{
    "name": "Dirección para envíos",
    "locationTypes": ["SH"]
}

Respuestas

Correcta:

JSON
[
	{
        "locationId": 2,
        "additionalData": "",
        "addressLine1": "Calle río Ebro 1",
        "addressLine2": "",
        "city": "Madrid",
        "countryId": 63,
        "county": "",
        "locationTypes": ["SH"],
        "mainLocation": false,
        "name": "Dirección para envíos",
        "stateId": 28,
        "zipCode": "28001"
    }
]

Error:

JSON
{"code":"3312"}
JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.