Mandato AddressAdd
Este mandato añade una nueva entrada de dirección para un usuario o una organización.
Utilice este mandato con SSL (Secure Sockets Layer) para asegurarse de
que la contraseña de conexión del cliente y la información personal estén
cifradas. Para ello, escriba el mandato con el protocolo seguro HTTPS.

Valores de parámetros
- http://nombre_sistpral/vía de acceso/
- (Obligatorio) El nombre totalmente calificado del servidor WebSphere Commerce
y la vía de acceso de configuración.
- langId
- Establece o restaura el idioma preferido para la duración de la sesión;
los idiomas soportados para una tienda se encuentran en la tabla
STORELANG.
- forUser
- El ID de conexión del usuario u organización en cuyo nombre se ejecutará el
mandato; este parámetro sólo lo puede especificar una persona con
autorización para procesar pedidos.
- forUserId
- Igual que forUser, pero identifica al usuario mediante el ID de usuario interno, como se encuentra en la
tabla USERS.
- memberId
- Si no se especifica memberId, el valor por omisión es el usuario actual
(el usuario que se está conectando). Este parámetro puede utilizarse
para añadir una dirección para entidades de organización u otros
usuarios.
- URL
- (Obligatorio) El URL al que se debe llamar cuando el mandato se completa satisfactoriamente.
- businessTitle
- El puesto en la empresa de la persona cuya dirección se va a añadir (por ejemplo, Presidente
o Director).
- nickName
- (Obligatorio) El apodo o identificador de la dirección que se va a añadir. Un miembro
puede tener varias direcciones, cada una de ellas con un apodo. El sistema trata la
dirección que proporciona un usuario cuando se registra como la dirección propia del
usuario y establece el apodo de dicha dirección en el ID de conexión del usuario.
- personTitle
- El tratamiento que se dará al usuario cuya dirección se va a entrar (por ejemplo,
Dr., Sr. o Sra.).
- lastName
- El apellido del usuario.
- firstName
-
El nombre del usuario.
- middleName
-
El segundo nombre o inicial del usuario
- organizationName
-
La organización a la que representa el usuario.
- organizationUnitName
- El nombre de la unidad dentro de la organización del usuario.
- officeAddress
- La dirección interna de la organización (por ejemplo, código postal interno).
- primary
- Si la dirección especificada es o no una dirección primaria para un tipo de dirección determinado:
1= es la primaria
0=no es la primaria (es el valor por omisión)
- addressType
- El tipo de dirección, por ejemplo:
R=residencia (este es el valor por omisión)
M=mailing
S=de envío
B=de facturación
SB=de envío y facturación
Si no se especifica addressType, el valor por omisión es "SB"
- address1
-
La primera línea de la dirección postal del usuario.
- address2
-
La segunda línea de la dirección postal del usuario.
- address3
-
La tercera línea de la dirección postal del usuario.
- city
-
El nombre de la ciudad donde reside el usuario.
- state
-
El nombre de la provincia, estado o equivalente donde reside el usuario
- zipCode
-
El código postal de la dirección del usuario
- country
-
El nombre del país o región donde reside el usuario.
- bestCallingTime
- Si se ha de llamar al usuario durante el día o por la noche
- phone1
- El número de teléfono primario del usuario.
- phone1Type
-
El tipo de teléfono utilizado para el número de teléfono primario del usuario, por ejemplo TTY para personas con problemas de audición, PCM para
modulación por pulsos o CEL para teléfono móvil. Este campo es de 3
caracteres.
- publishPhone1
-
Si se ha de listar o no el número de teléfono primario del usuario:
Y=sí
N=no
- phone2
- El número de teléfono secundario del usuario.
- phone2Type
-
El tipo de teléfono utilizado para el número de teléfono secundario del usuario, por ejemplo TTY para personas con problemas de audición, PCM para
modulación por pulsos o CEL para teléfono móvil. Este campo es de 3
caracteres.
- publishPhone2
-
Si se ha de listar o no el número de teléfono secundario del usuario:
Y=sí
N=no
- fax1
-
El número de fax primario del usuario.
- fax2
-
El número de fax secundario del usuario.
- email1
-
La dirección de correo electrónico o Web primaria del usuario.
- email2
-
La dirección de correo electrónico o Web secundaria del usuario.
- billingCode
- El código de la organización compradora para identificar las direcciones de envío o
facturación y el centro de costes.
- billingCodeType
- El código que designa el método de la estructura de código que se utiliza para el código de facturación.
El valor por omisión es D y
lo asigna el comprador. El valor 02 indica que lo asigna Ariba.
- taxPayerId
- Una serie que se utiliza para identificar al usuario para impuestos; resulta
especialmente útil con software de impuestos.
- packageSuppression
-
Si se ha de incluir o no material publicitario cuando se envíe el pedido:
1=incluir
0=no incluir
- addressfield1 hasta addressfield3
-
Campos personalizables.
- shippingGeoCode
- Un código de envío basado en la región geográfica; resulta especialmente útil con
software de impuestos.
- taxGeoCode
- Un código de impuestos basado en la región geográfica; resulta especialmente útil con
software de impuestos.
Ejemplo 1
El ejemplo siguiente añade una entrada a la tabla de direcciones utilizando el apodo
"mother_address."
https://misistpral/webapp/wcs/stores/servlet/AddressAdd?
nickName=mother_address&address1=7+Elm+St.&city=Toronto&state=Ontario
&country=Canada&zipCode=M4M+2T1&lastName=Lee&URL=/
Ejemplo 2
El ejemplo siguiente añade una dirección de facturación completa.
https://myhostname/webapp/wcs/stores/servlet/AddressAdd?URL=basemall.jsp&nickName=msur1nickB
&addressType=B&primary=1&personTitle=Dr&lastName=last&firstName=first
&middleName=middle&address1=address1&address2=address2
&address3=address3&city=Toronto&state=Ontario&country=Canada
&zipCode=A1A1A1&phone1=111-111-1111&phone2=222-222-2222
&phone1Type=PHN&phone2Type=TTY&publishPhone1=1&publishPhone2=0
&bestCallingTime=E&fax1=333-333-3333&fax2=444-444-4444
&email1=msur1nickB@email1.com&email2=msur1nickB@email2.com
&businessTitle=bustitle&organizationName=organization
&organizationUnitName=oraganizationunit&officeAddress=officeaddress
&packageSuppression=0&addressField1=field1&addressField2=field2
&addressField3=field3&billingCode=billingCode&billingCodeType=BT
&shippingGeoCode=shippinggeocode&taxGeoCode=taxgeocode
Nota: Para las direcciones temporales y permanentes, cada miembro puede tener
varias direcciones. Cuando se crea una dirección,
su estado se marca con una "P", que significa
"permanente" e indica que es la dirección actual. Cuando se actualiza
una dirección, se crea un nuevo registro de la dirección con las actualizaciones. El
nuevo registro se marca con una "P" y el registro anterior se marca con una
"T", que significa "temporal" e indica que es la dirección
histórica.
Cuando se suprime una dirección con el mandato
AddressDelete, su estado se marca con
una "T".
Comportamiento
- Para cada tipo de dirección, puede haber cero o una dirección primaria (el campo primary es igual a 1).
Si la nueva dirección es la primaria, entonces este mandato cambiará la
dirección primaria existente de este tipo de dirección (si existe) a no
primaria.
- Si no se especifica el parámetro primary, el valor por omisión es 0 (no primaria).
- Si no se especifica el parámetro addressType, el valor por omisión es 'R' (residencia).
- Comprueba si el apodo especificado ya está utilizándose.
- Llama al mandato de tarea AuditAddressCmd para que ejecute una comprobación adicional de los parámetros.
Los desarrolladores de tiendas deben añadir código nuevo al mandato de tarea AuditAddressCmd
si desean personalizar la comprobación.
- Crea una nueva dirección en la tabla
ADDRESS.
- Si el miembro no tiene un listín, entonces se crea un nuevo registro en la tabla ADDRBOOK.
- Si el mandato no se ejecuta correctamente, se llama al mandato AddressErrorView.
- Una vez ejecutado correctamente, llama al URL especificado.
Condiciones de excepción
- El parámetro URL no puede ser nulo y su longitud debe ser mayor que 0.
- El parámetro nickName no debe ser nulo, su longitud debe ser mayor que 0 y no debe existir en este listín.
- El parámetro primary debe ser nulo o debe ser igual a 0 ó 1.
- Los parámetros publishPhone1, publishPhone2 y packageSupression deben ser nulos o deben ser un entero.