BANCO NACIONAL DE PANAMÁ, BANCO DE DESARROLLO AGROPECUARIO Y BANCO HIPOTECARIO NACIONAL

Transcripción

1 BANCO NACIONAL DE PANAMÁ, BANCO DE DESARROLLO AGROPECUARIO Y BANCO HIPOTECARIO NACIONAL LICITACION ABREVIADA POR PONDERACIÓN Nº AV MANUAL DE INTERFASES

2 TABLA DE CONTENIDOS INTRODUCCIÓN A LA RED ACH FUNCIONALIDAD ACH EN e-ibs Operadores e Instituciones Clases Transacciones Parámetros Recibir Archivo ACH Retornos Ingresar Lotes Aprobar Enviar Archivo ACH Autorizaciones Consultar Instituciones Consultar Autorizaciones Reportes y Otros Procesos DOCUMENTACION SERVICIOS DE CLIENTE DOCUMENTACIÓN - CONSULTA DE CLIENTE DOCUMENTACION - CREDIT CARD PAYMENT DOCUMENTACION - SERVICIOS DE CUENTAS DOCUMENTACION - SERVICIOS DE PRESTAMOS DOCUMENTACION - WEB SERVICES METODOLOGIA INTEGRACION - IBS ULTIMUS DATAPRO BUILDING

3 THE AUTOMATED CLEARING HOUSE (ACH) NETWORK Automated Clearing House (ACH) es el nombre de una red electrónica de transacciones financieras en Estados Unidos. El sistema de pagos ACH fue diseñada para permitirle a corporaciones y clientes reducir o eliminar el uso de cheques en papel para realizar pagos rutinarios. El sistema ACH puede procesar grandes volúmenes de pagos individuales electrónicamente, al igual que grandes volúmenes de transacciones de ambos créditos y debitos originados en lotes. Las regulaciones que gobiernan la red son establecidas por NACHA The Electronic Payments Association o Asociación de Pagos Electrónicos (anteriormente National Automated Clearing House Association), y por la Reserva Federal (Fed). En el resto del mundo, las reglas son definidas por los cuerpos reguladores de cada país. Transferencias de crédito ACH incluyen pagos de planilla de personal con depósito directo, así como pagos a contratistas y proveedores de servicios. Transferencias de debito ACH incluyen pagos de consumidores por primas de seguros, préstamos hipotecarios, o cualquier otro tipo de cuenta a pagar. Pagos a través de ACH incluyen: Deposito Directo de Planilla de Empleados, pagos de Seguro Social y otros beneficios gubernamentales, y reembolsos de impuestos. Pagos directos de cuentas del consumidor tales como hipotecas, prestamos, servicios de agua y electricidad, y primas de seguros. Compra de Acciones. Consolidación de saldos en efectivo de Corporaciones. Pagos de Compañía a Compañía. Cheques electrónicos (E-checks) Pagos comerciales electrónicos (E-commerce) Pagos de impuestos locales, estatales y federales. DATAPRO BUILDING 2

4 TERMINOLOGÍA GENERAL ACH ACH TYPE TRANSACTIONS o Transacciones Tipo ACH no están sujetas a Stop Payments y las suspensiones de pago serán rechazados por el sistema. ORIGINATOR u Originador Cualquier individuo, corporación u otra entidad que inicie una entrada en la red Automated Clearing House Network. ORIGINATING DEPOSITORY FINANCIAL INSTITUTION (ODFI) o Institución Financiera Originadora de Depósitos Una institución financiera participante que origina entradas ACH por solicitud de y en acuerdo con (ODFI) sus clientes. Los ODFI deben acatar las provisiones establecidas por NACHA Operating Rules and Guidelines. RECEIVING DEPOSITORY FINANCIAL INSTITUTION (RDFI) o Institución Financiera Recibidora de Depósitos Cualquier institución financiera calificada parta recibir entradas ACH la cual esté de acuerdo en acatar las reglas y guías del NACHA Operating Rules and Guidelines. RECEIVER o Recibidor Cualquier individuo, corporación u otra entidad la cual haya autorizado a un originador para iniciar una entrada de crédito o debito a una cuenta mantenida por un RDFI. Nota: Esta introducción al ACH es solo una breve descripción. Para mayor información vea la literatura de la red ACH. DATAPRO BUILDING 3

5 RECIBIDOR ORIGINADOR RDFI emite los fondos y registra en estado de cuenta Recibidor autoriza al originador ACH Originador proporciona datos de transacción a a ODFI Operador ACH distribuye archivo ACH a RDFI RDFI ODFI organiza y transmite archivo al operador ACH ODFI DATAPRO BUILDING 4

6 FUNCIONALIDAD ACH EN EL e-ibs Después de haber establecido los parámetros para la interacción del IBS con la Interfaz ACH, el usuario final puede fácilmente realizar sus tareas a través del modulo Interfaz ACH del e-ibs 4.8: Instituciones Clases Transacciones Parámetros Recibir Archivo ACH Retornos Ingresar Lotes Aprobar Enviar Archivo ACH DATAPRO BUILDING 5

7 Autorizaciones Consultar Instituciones Consultar Autorizaciones INSTITUCIONES La opción de menú Instituciones del e-ibs le permite al usuario crear, dar mantenimiento y eliminar Operadores (código asignado al banco para realizar transacciones ACH), Instituciones Financieras (institución aprobada por ACH para realizar transacciones) y/o Compañías (con la que se realiza una transacción ACH). Para obtener acceso a la opción de menú Instituciones: - En el menú principal e-ibs, seleccione Interfaces ACH. - En el menú Interfaces ACH, seleccione Operadores e Instituciones. Se abrirá la pantalla Operadores ACH: DATAPRO BUILDING 6

8 Para realizar una búsqueda: - Ingrese el código del registro y oprima la casilla junto al campo. Para crear un nuevo registro: - Oprima Nuevo. Se abrirá la siguiente pantalla Mantenimiento de Operadores ACH: - Ingrese el nuevo Código. Campo obligatorio. Los códigos para Operadores e Instituciones Financieras son de 9 posiciones. Los códigos para las Compañías son de 10 posiciones. - Ingrese el Nombre del nuevo operador, institución o compañía. El campo tiene treinta posiciones. - En el campo Tipo, oprima la casilla y seleccione si se trata de un operador, una institución financiera, o una compañía. Campo obligatorio. - En el campo Tipo de Oficina, oprima la casilla y seleccione si se trata de la oficina principal o de una sucursal. - Ingrese la Dirección correspondiente al registro. El campo tiene 35 posiciones. DATAPRO BUILDING 7

9 - Ingrese la Ciudad, el Estado y el Código Postal de la dirección. - En el campo Usando, oprima la casilla y seleccione entre: Federal (para códigos asignados por el FED) Normal (todo código de Institución financiera y compañía), o Nueva (se utiliza cuando un código previamente existente ha sido reemplazado por uno nuevo, ver campo Nueva Ruta. - En el campo Sirviendo a, ingrese el código de operador al que deben ser transferidas las operaciones (si aplica), u oprima el icono para hacer una búsqueda en la pantalla de ayuda. Ejemplo de pantalla: - En el campo Nueva Ruta, ingrese (si aplica) el nuevo número que reemplaza el código anterior (ver campo Usando), u oprima el icono para hacer una búsqueda en la pantalla de ayuda. - Oprima Someter. DATAPRO BUILDING 8

10 Para actualizar un registro ya existente: - Seleccione el registro y oprima Modificar. Se abrirá la pantalla Mantenimiento de Operadores ACH correspondiente: - Realice sus cambios y oprima Someter. Para borrar un registro ya existente: - Seleccione el registro y oprima Eliminar: El sistema solicitará confirmación: DATAPRO BUILDING 9

11 Para proceder, oprima Ok. CLASES La opción de menú Clases del modulo Interfaz ACH le permite al usuario crear y actualizar diferentes clasificaciones de entradas ACH en el sistema. Para obtener acceso a la opción de menú Clases: - En el menú principal e-ibs, seleccione Interfaces ACH. - En el menú Interfaces ACH, seleccione Clases. Se abrirá la pantalla Clases Entradas ACH: DATAPRO BUILDING 10

12 Para crear una nueva clase: - Oprima Nueva Clase. La pantalla Clases de Entradas ACH desplegará una línea adicional de campos vacíos: - Ingrese tres dígitos para definir la Clase de entrada. Campo obligatorio. - Ingrese Descripción de la misma. Campo tiene 45 posiciones. Campo obligatorio. - Defina si se requerirá Aprobación para Salida, y/o para Debitos de Entrada. Campo obligatorio. - En Adenda, oprima la casilla y seleccione si esta será Opcional u Obligatorio. Campo obligatorio. DATAPRO BUILDING 11

13 - Ingrese el Numero de Adendas. Campo obligatorio. - Defina un Máximo Valor por Entrada. Campo obligatorio. - Ingrese el código que identifica a una Compañía por Omisión, u oprima el icono para seleccionar una en la pantalla de ayuda. Ejemplo de pantalla de ayuda: Para borrar una clase de entrada ACH existente: - Seleccione la casilla Borrar que precede la entrada. Al terminar con todos sus ingresos y cambios: - Oprima Someter Actualizaciones. DATAPRO BUILDING 12

14 TRANSACCIONES Esta opción de menú le permite al usuario ingresar un nuevo lote, modificar o borrar un lote ya existente, al igual que ver y modificar las transacciones de un lote. Para obtener acceso a la opción de menú Transacciones: - En el menú principal del e-ibs, seleccione Interfaz ACH. - En el menú Interfase ACH, seleccione Transacciones. Se abrirá la pantalla Transacciones de ACH: DATAPRO BUILDING 13

15 Parte izquierda de la pantalla. Parte derecha de la pantalla. Para ingresar un nuevo registro: - Oprima Nueva Transacción. La pantalla desplegará una línea de campos adicional: DATAPRO BUILDING 14

16 - Ingrese Código (hasta 3 dígitos) y Descripción (45 posiciones). Campos obligatorios. - En el campo Tipo, oprima la casilla y seleccione si es una Transacción, un Retorno, o una Prenotificación. Campo obligatorio. - En DB ó CR, oprima la casilla y defina si la transacción es un CR crédito, o un DB Debito. Campo obligatorio. - Seleccione la casilla Con Monto, si la transacción contiene un monto adjunto. - Ingrese un Código de Retorno, u oprima el icono para seleccionar el código en la pantalla de ayuda. Ejemplo de pantalla: DATAPRO BUILDING 15

17 - Ingrese un Código IBS o código interno para asignar a la transacción u oprima el icono para seleccionar el código en la pantalla de ayuda. - Seleccione el Tipo de Cuentas IBS en las que la transacción será permitida: Cheques, Ahorros, Préstamos, Tarjeta Crédito, Cuenta Contable. Campo obligatorio. - Oprima Someter Actualizaciones después de hacer sus ingresos y cambios. DATAPRO BUILDING 16

18 PARAMETROS La opción de menú Parámetros del e-ibs le permite al usuario crear y actualizar los parámetros para los registros de bancos con los cuales la institución realizara transacciones. Para obtener acceso a la opción de menú Parámetros: - En el menú principal e-ibs, seleccione Interfaz ACH. - En el menú Interfaz ACH, seleccione Parámetros. Se abrirá la pantalla Parámetros de ACH: Para definir nuevos parámetros: - Oprima Nueva. Se abrirá una línea horizontal con los campos necesarios para la creación del nuevo registro: Vista parcial (izquierda) de la pantalla. DATAPRO BUILDING 17

19 - Ingrese el código numérico del Operador u oprima el icono para hacer una búsqueda. Campo obligatorio. - Ingrese el número de Lote Contable para las operaciones de entrada. Campo obligatorio. - Ingrese el número de cuenta ACH para las operaciones de entrada, u oprima el icono para hacer una búsqueda. Campo obligatorio. - En la columna Aplicar, seleccione las opciones que aplican a este banco/operador: Cargos NFS (cargos por fondos insuficientes), Retornos (para manejar retornos de manera automática), y Aprobación (si el lote contable de transacciones requiere aprobación). - Ingrese el número de Lote Contable para operaciones de salida. Campo obligatorio. - Ingrese el número de Cuenta ACH para las operaciones de salida, u oprima el icono para hacer una búsqueda. La cuenta ACH para operaciones de salida puede ser la misma cuenta para operaciones de entrada. Campo obligatorio. - En el campo Cuenta Puente ingrese el número de cuenta de contrapartida, u oprima el icono Campo obligatorio. para hacer una búsqueda. - Oprima Someter Actualizaciones después de hacer sus ingresos y cambios. DATAPRO BUILDING 18

20 RECIBIR ARCHIVO ACH La opción de menú Recibir Archivo ACH del e-ibs le permite al usuario ingresar un archivo en formato NACHA y aplicar las transacciones de entrada contenidas en el mismo. Para obtener acceso a la opción de menú Recibir Archivo ACH: - En el menú principal del e-ibs, seleccione Interfase ACH. - En el menú Interfase ACH, seleccione Recibir Archivo ACH. Se abrirá la pantalla Procesar Archivo Entrante de ACH: - Oprima Browse para buscar el archivo que desea cargar: Ó - Ingrese el Nombre del Archivo y oprima Procesar. Si el archivo tiene el formato correcto, el sistema producirá el reporte ACH 400 en el cual se verán los errores si los hay; y/o las transacciones procesadas. Adicionalmente el usuario podrá generar el reporte GL0020 con el número de lote definido en los parámetros, para ver las transacciones DATAPRO BUILDING 19

21 aplicadas al IBS. El archivo debe ser procesado una sola vez, y el sistema verificara que no haya la duplicidad del mismo. RETORNOS Si en los parámetros creados se definió que el sistema procesara automáticamente los retornos, la pantalla de esta opción listara los retornos incluidos en el recibo de archivo ACH. Esta opción de menú le permite al usuario aceptar, borrar y procesar retornos pendientes. Adicionalmente el usuario podrá consultar los datos del cliente relacionado al retorno, previo a tomar una decisión sobre el mismo. Para obtener acceso a la opción de menú Retornos: - En el menú principal del e-ibs, seleccione Interfase ACH. - En el menú Interfase ACH, seleccione Retornos. Se abrirá la pantalla Retornos ACH Pendientes: CONSULTAR CUENTAS Para consultar los datos de un retorno pendiente: - Seleccione el registro y oprima Consultar Cuentas. Se abrirá una pantalla de búsqueda. Ú DATAPRO BUILDING 20

22 - Oprima su cursor sobre el número de cuenta a consultar. ACEPTAR / ENVIAR SELECCIÓN es solo un activador o switch, que se utiliza para marcar un retorno. Si selecciona un retorno y oprime aceptar, el estatus del mismo se convertirá a aceptar pero permanecerá en la lista. Si selecciona un retorno con estatus aceptar y oprime la opción aceptar, el retorno volverá al estatus enviar. Para aceptar un retorno pendiente: - Seleccione el registro y oprima Aceptar. El sistema solicitará confirmación: - Oprima Ok. El estado del registro cambiará a Aceptar. - Oprima Procesar. Ejemplos: 1) Si la cuenta de un retorno no tiene fondos suficientes, y el usuario lo marca aceptar y lo procesa, el sistema forzará la transacción y sobregirará la cuenta. 2) Si la cuenta no existe, y el usuario lo marca aceptar y lo procesa, el sistema enviará la transacción a la cuenta de suspenso. BORRAR / ENVIAR SELECCIÓN se utiliza cuando se quiere borrar un retorno y manejarlo manualmente y la opción de Borrar en si es solo un activador o switch para marcar el retorno. Si selecciona un retorno y oprime Borrar, el estatus del mismo se convertirá a borrar pero permanecerá en la lista. Si selecciona un retorno con estatus borrar y oprime la opción borrar, el retorno volverá al estatus enviar. Para borrar un retorno pendiente: - Seleccione el registro y oprima Borrar Selección. El estatus del registro cambiará a Borrar. - Oprima Procesar. DATAPRO BUILDING 21

23 PROCESAR ACTUALIZACIONES es la opción que ejecuta las directivas definidas para los retornos. INGRESAR LOTES La opción de menú Ingresar Lotes del e-ibs le permite al usuario ingresar, modificar /o borrar lotes en el sistema. Adicionalmente, esta opción le permite al usuario ingresar y modificar transacciones dentro de un lote ya existente. Para obtener acceso a Ingresar Lotes: - En el menú principal del e-ibs, seleccione Interfase ACH. - En el menú Interfase ACH, seleccione Ingresar Lotes. Se abrirá la pantalla Entrada de Lotes de Salida ACH: Para ingresar un lote saliente al sistema: - Oprima Nuevo Lote. Se abrirá la pantalla Entrada de Lotes Salientes ACH: DATAPRO BUILDING 22

24 Para modificar un lote saliente ya ingresado al sistema: - Seleccione el lote y oprima Modificar Lote. Se abrirá la pantalla Entrada de Lotes Salientes ACH correspondiente a su selección: - Haga sus cambios y oprima Someter. Para eliminar un lote saliente ya ingresado al sistema: - Seleccione el lote y oprima Borrar Lote. DATAPRO BUILDING 23

25 Para ingresar o modificar TRANSACCIONES en un lote ya existente: - Seleccione el lote en la pantalla y oprima Transacciones. Se abrirá la pantalla Transacciones para el Lotes ACH correspondiente a su selección: Para ingresar una nueva transacción: - Oprima Nueva Transacción: Se abrirá la pantalla Transacción # para el Lote ACH Nro. #: DATAPRO BUILDING 24

26 - Ingrese el número de Cuenta Interna u oprima el icono para seleccionar la cuenta en la pantalla de ayuda. Campo obligatorio. - Ingrese el código de Transacción ACH u oprima el icono para seleccionar la cuenta en la pantalla de ayuda. Campo obligatorio. Ejemplo de pantalla de ayuda: - Ingrese el código de Ruta, u oprima el icono para seleccionar la ruta en la pantalla de ayuda. DATAPRO BUILDING 25

27 - Ingrese el número de Cuenta Externa (si aplica), y oprima la casilla para seleccionar si es una cuenta de Cheques, Ahorros, Préstamos o Tarjeta de Crédito. - Ingrese Monto de Transacción y código de Moneda. - Ingrese código de Referencia. - Ingrese nombre de Beneficiario y su información. - Oprima Someter. Para modificar una transacción ya existente: - Seleccione transacción y oprima Modificar Transacción: Se abrirá la pantalla Transacción # para el Lote ACH Nro. # correspondiente. - Realice sus cambios y oprima Someter. APROBAR La opción de menú Aprobar del e-ibs le permite al usuario aprobar lotes en cola de aprobación, al igual que ver los detalles y transacciones del mismo. Para obtener acceso a Aprobar: - En el menú principal del e-ibs, seleccione Interfaz ACH. - En el menú Interfase ACH, seleccione Aprobar. Se abrirá la pantalla Aprobación de Lotes de Salida ACH: DATAPRO BUILDING 26

28 Para aprobar un lote en cola de aprobación: - Seleccione el lote y oprima Aprobar Lote. Para ver los detalles de un lote en cola de aprobación: - Seleccione el lote y oprima Ver Detalle del Lote. Se abrirá la pantalla correspondiente: Para ver las transacciones en un lote en cola de aprobación: - Seleccione el lote y oprima Ver Transacciones. Se abrirá la siguiente pantalla de Transacciones: DATAPRO BUILDING 27

29 - Seleccione la transacción y oprima Ver Transacción. Se abrirá la siguiente pantalla: ENVIAR ARCHIVO ACH DATAPRO BUILDING 28

30 La opción de menú Enviar Archivo ACH del e-ibs le permite al usuario generar el archivo ACH con las transacciones y retornos que con fechas anteriores o iguales a la fecha del proceso. Para obtener acceso a Enviar Archivo ACH: - En el menú principal del e-ibs, seleccione Interfase ACH. - En el menú Interfase ACH, seleccione Enviar Archivo ACH. Se abrirá la pantalla Generar Archivo Saliente de ACH: - Oprima Generar. El sistema salvará el archivo en formato NACHA para enviar. Nota: El archivo puede generarse una sola vez. AUTORIZACIONES DATAPRO BUILDING 29

31 La opción de menú Autorizaciones del e-ibs le permite al usuario registrar cuando un cliente autoriza al banco a que una compañía debite de su cuenta para la cuenta ACH. Debe existir un registro por cada una de las cuentas y las compañías que se quieren ingresar. Para obtener acceso a la opción de menú Autorizaciones: - En el menú principal del e-ibs, seleccione Interfase ACH. - En el menú Interfase ACH, seleccione Autorizaciones. Se abrirá la pantalla Autorizaciones ACH: La línea inicial con los campos Cliente, Cuenta, Compañía y Nombre son campos de búsqueda. Ingrese un criterio y oprima para hacer la búsqueda. Ejemplo: Si en el campo Nombre se busca con la letra C, la lista de los clientes pendientes de autorización comenzará con los nombres de letra C. Si en el campo Cuenta se busca con el número 1, la lista de los clientes pendientes de autorización comenzará con las cuentas que empiezan con el 1. DATAPRO BUILDING 30

32 Para borrar una autorización ya existente: - Seleccione el registro oprima Eliminar. El sistema solicitará confirmación: - Para proceder, oprima Ok. Para actualizar una autorización ya existente: - Seleccione el registro oprima Actualizar. Se abrirá la pantalla Autorizaciones de Clientes ACH correspondiente: En esta pantalla pueden modificarse la fecha de efectividad, el monto máximo y el estatus de la autorización. - Realice sus cambios y oprima Someter. DATAPRO BUILDING 31

33 Para crear una nueva autorización: - Oprima Nueva. Se abrirá la siguiente pantalla Autorizaciones de Clientes ACH: - Ingrese el Código de Cliente u oprima el icono para hacer una búsqueda. Campo obligatorio. - Ingrese el Nombre del cliente. - Ingrese el número de Cuenta que será afectada, u oprima el icono para hacer una búsqueda. Campo obligatorio. - Ingrese el número de Compañía a acreditar (previamente definida), u oprima el icono para hacer una búsqueda. Campo obligatorio. - Ingrese el Nombre de la Compañía. - Ingrese la Fecha de Efectividad de la nueva autorización, u oprima el icono para seleccionar la fecha en el calendario. Campo obligatorio. - Defina el Monto Máximo autorizado para las transacciones. - En el campo Estado, oprima la casilla y seleccione el actual estado de la autorización: Activo o Inactivo. - Oprima Someter. Si el estado de la autorización es Inactivo, o el monto de la transacción es superior al monto máximo definido, la transacción será devuelta y colocada en la lista de retornos. DATAPRO BUILDING 32

34 CONSULTAR INSTITUCIONES La opción de menú Consultar Instituciones del e-ibs le permite al usuario consultar la información especifica de cada uno de los operadores ACH ingresados en el sistema. Para obtener acceso a la opción de menú Consultar Instituciones: - En el menú principal del e-ibs, seleccione Interfase ACH. - En el menú Interfase ACH, seleccione Consultar Instituciones. Se abrirá la pantalla Operadores ACH: - Seleccione la institución y oprima Consultar. Se abrirá la pantalla Mantenimiento de Operadores ACH correspondiente: - Esta pantalla no permite modificaciones. DATAPRO BUILDING 33

35 CONSULTAR AUTORIZACIONES La opción de menú Consultar Autorizaciones del e-ibs le permite al usuario consultar la información correspondiente a cada una de las autorizaciones ACH existentes en el sistema. Para obtener acceso a la opción de menú Consultar Autorizaciones: - En el menú principal del e-ibs, seleccione Interfase ACH. - En el menú Interfase ACH, seleccione Consultar Autorizaciones. Se abrirá la pantalla Autorizaciones ACH: - Seleccione la autorización y oprima Consultar Autorización. Se abrirá la pantalla Autorizaciones de Cliente ACH correspondiente: DATAPRO BUILDING 34

36 - Esta pantalla no permite modificaciones. REPORTES Y OTROS PROCESOS La opción de menú Reporte y Otros Procesos del e-ibs le permite al usuario generar reportes o ejecutar procesos que liberara los créditos de ACH a las cuentas de detalle respectiva sin importar el número de días de Retención que tengan las transacciones de ACH de ese número de agencia. Para obtener acceso a la opción de menú Reportes y Otros Procesos: - En el menú principal del e-ibs, seleccione Interfase ACH. - En el menú Interfase ACH, seleccione Reportes y Otros Procesos. Nota: Procesando los reportes generara el reporte ACHnnn (ej. ACH305), el usuario debe tener asignada la seguridad para verlo en el Spool de usuario. - Seleccione el proceso y oprima Procesar para abrir las siguientes opciones. Liberación de Diferidos DATAPRO BUILDING 35

37 - En esta sección, ingrese el código de agencia y oprima la opción Procesar. Lista de Autorizaciones ACH - Seleccione esta opción y oprima procesar. Lista de Retornos ACH - En la seccion de Estado Rechazos, ingrese (P) por Pendiente, (F) por Forzar, (D) por Borrar, (S) para Enviar, o (*) para Indicado. - En Fecha Inicial, ingrese la fecha en el formato de DDMMAA. - En Fecha Final, ingrese la fecha en el formato de DDMMAA. - Oprima Procesar para enviar Lista de Transacciones de Entrada ACH DATAPRO BUILDING 36

38 - En Tipo, ingrese uno de los siguientes códigos: ALL=Todas RET=CHK/AHO CC=Tarjeta GL= Cuentas Cont. - En Fecha Inicial, ingrese la fecha en el formato de DDMMAA. - En Fecha Final, ingrese la fecha en el formato de DDMMAA. - Oprima Procesar para enviar Lista de Transacciones de Salida ACH - En Tipo, ingrese uno de los siguientes códigos: ALL=Todas RET=CHK/AHO CC=Tarjeta GL= Cuentas Cont. - En Fecha Inicial, ingrese la fecha en el formato de DDMMAA. - En Fecha Final, ingrese la fecha en el formato de DDMMAA. - Oprima Procesar para enviar DATAPRO BUILDING 37

39 DOCUMENTACION DE ENTREGA - SERVICIOS DE CLIENTES Revisiones Fecha Versión Descripción Autor 11 de Agosto 1.0 Creación Catalina Sepúlveda 20 de Agosto Inclusión parámetro user en el Catalina Sepúlveda servicio. - Inclusión de detalle de clases. 11 de Septiembre Inclusión de campos descripción. - Descripción detallada de mensajes de error y campos con valores fijos. Catalina Sepúlveda 15 de Septiembre Inclusión de servicio de mantenimiento de clientes. Catalina Sepúlveda 10 de Octubre Inclusión nuevos campos al servicio. Catalina Sepúlveda 27 de Octubre Separación de servicio Nuevo y Mantenimiento. Catalina Sepúlveda DOCUMENTACION DE ENTREGA SERVICIOS DE CLIENTES DATAPRO BUILDING 38

40 1. DEPLOYMENT: NOMBRE TIPO FUNCION Axis2 WAR Web Services Engine customerservice AAR Deployment File 2. DEFINICION DE COMPONENTES: NOMBRE TIPO FUNCION customerservice.wsdl WSDL Web Service Description CustomerServiceSkeleton JAVA Class for service impl. EWS000001Message JAVA Message Class. EWS001001Message JAVA Message Class 3. RESUMEN DE METODOS FUNCIONALES personalcustomerinquiry: Servicio de consulta de clientes personales. Parámetros: o <user>- un tipo de dato String; envía el usuario que solicita la transacción. o <customerid>- un tipo de dato String; envía el numero de documento de identificación del cliente. Retorna: <PersonalCustMessage> - una estructura de datos compuesta con toda la data de cliente definida en el WSDL. Error: <Validation Error> - Estructura de mensaje de error usando un tipo de excepción errormessage definido en el WSDL. personalcustomermaintenance: Servicio de mantenimiento de clientes personales, se debe incluir el numero de cliente en el mensaje. Parámetros: <PersonalCustMessage> - una estructura de datos compuesta con toda la data de cliente definida en el WSDL. Retorna: <PersonalCustMessage> - una estructura de datos compuesta con toda la data de cliente definida en el WSDL. Error: <Validation Error> - Estructura de mensaje de error usando un tipo de excepción errormessage definido en el WSDL. newpersonalcustomer: Servicio de creación de cliente personal. El campo numero de cliente se debe enviar en ceros, el mensaje de respuesta debe retornar el nuevo numero de cliente generado. Parámetros: <PersonalCustMessage> - una estructura de datos compuesta con toda la data de cliente definida en el WSDL. DATAPRO BUILDING 39

41 Retorna: <PersonalCustMessage> - una estructura de datos compuesta con toda la data de cliente definida en el WSDL. Error: <Validation Error> - Estructura de mensaje de error usando un tipo de excepción errormessage definido en el WSDL. El mensaje de error es un mensaje SOAP, sin embargo este mensaje se genera únicamente cuando se arroja una exception desde el método publicado. Esto quiere decir que en el cliente, el mensaje de error va a ser obtenido en un catch. Actualmente esta siendo enviado en un String con la forma: <código de error>-<descripción del error> Los códigos de error corresponden a los mismos códigos que se manejan en el e-ibs para las validaciones de formularios. Se adicionó la descripción de los campos que se parametrizan en tablas, algunos de los códigos corresponden a valores fijos, el detalle de estos valores se detalla en la siguiente tabla: CAMPO DETALLE legalstatus 1=Soltero(a), 2=Casado(a), 3=Divorciado(a), 4=Viudo(a), 5=otros Sex M=Masculino, F=Femenino relationtype 1 Cliente Regular 2 Especial 3 Empleado 4 Funcionario 5 Director 6 Pariente 7 Empresa Afiliada 8 Junta Directiva 8 Banco Corresponsal clientstatus 1=activo, 2=inactivo, 3=Lista negra clienttype 1=corporacion, 2=persona natural, 3=otros clientclass 1=Entidad Gubernamental, 2= ente descentralizado, N=No aplica language s=español e=ingles taxes Valores Fijos de 1 a 9 o N 4. FUNCIONALIDAD DATAPRO BUILDING 40

42 Para acceder a la funcionalidad de los web services se requiere construir un cliente partiendo del archivo WSDL que se adjunta en este entregable, el cliente del web service en este caso sería Ultimus, quienes en su aplicación construirán el cliente del servicio e intercambiarán mensajes SOAP por HTTP con el servicio de Datapro que se encuentra publicado en el siguiente URL: Se puede obtener el WSDL a través del URL: A continuación presentamos un pequeño ejemplo del manejo de los mensajes SOAP: Firma del Metodo PersonalCustMessage personalcustomerinquiry(string customerid); Donde el tipo complejo PersonalCustMessage es definido como PersonalCustMessage { String firstname; String secondname; String phonenumber; todos los campos de respuesta } Request <?xml version="1.0" encoding="utf-8" standalone="no"?> <SOAP-ENV:Envelope SOAP- ENV:encodingStyle=" xmlns:soap-env=" xmlns:soap-enc=" xmlns:xsi=" xmlns:xsd=" <SOAP-ENV:Body> <ns1:personalcustomerinquiry xmlns:ns1="urn:mysoapservices"> <user xsi:type="xsd:string">bptdatapro</user> <customerid xsi:type="xsd:string"> </customerid> </ns1:personalcustomerinquiry> </SOAP-ENV:Body> </SOAP-ENV:Envelope> Response <?xml version="1.0" encoding="utf-8"?> <SOAP-ENV:Envelope xmlns:xsi=" xmlns:xsd=" DATAPRO BUILDING 41

43 xmlns:soap-env=" <SOAP-ENV:Body> <ns1: personalcustomerinquiryresponse xmlns:ns1="urn:mysoapservices" SOAP- ENV:encodingStyle=" <return xsi:type="ns1:personalcustmessage"> <firstname xsi:type="xsd:string">bill</firstname> <secondname xsi:type="xsd:string">gate</secondname> <phonenumber xsi:type="xsd:string"> </phonenumber> Todos los campos de respuesta </return> </ns1: personalcustomerinquiryresponse> </SOAP-ENV:Body> </SOAP-ENV:Envelope> Con el archivo WSDL se pueden generar los elementos necesarios en el cliente para acceder el servicio. 5. ANEXOS <?xml version="1.0" encoding="utf-8"?> <wsdl:definitions targetnamespace=" xmlns:impl=" xmlns:intf=" xmlns:tns2=" xmlns:wsdl=" xmlns:wsdlsoap=" xmlns:xsd=" <wsdl:types> <schema elementformdefault="qualified" targetnamespace=" xmlns=" xmlns:impl=" xmlns:intf=" xmlns:wsdl=" xmlns:xsd=" <complextype name="personalcustmessage"> <sequence> <element name="user" nillable="true" type="xsd:string"/> <element name="idnumber" nillable="true" type="xsd:string"/> <element name="clienttype" nillable="true" type="xsd:string"/> <element name="idcountry" nillable="true" type="xsd:string"/> <element name="idtype" nillable="true" type="xsd:string"/> <element name="customernumber" nillable="true" type="xsd:string"/> <element name="firstname" nillable="true" type="xsd:string"/> <element name="secondname" nillable="true" type="xsd:string"/> <element name="firstlastname" nillable="true" type="xsd:string"/> <element name="secondlastname" nillable="true" type="xsd:string"/> <element name="marriedname" nillable="true" type="xsd:string"/> <element name="legalname" nillable="true" type="xsd:string"/> <element name="shortname" nillable="true" type="xsd:string"/> <element name="dependents" nillable="true" type="xsd:string"/> DATAPRO BUILDING <element name="sex" nillable="true" type="xsd:string"/> Ponce de Leon Blvd. 2nd <element Floor Coral name="legalstatus" Gables, FL T (305) nillable="true" F (305) 377-data type="xsd:string"/> <element name="nacionality" nillable="true" type="xsd:string"/> <element name="street" nillable="true" type="xsd:string"/>

44 type="xsd:string"/> <element name="residencycountry" nillable="true" type="xsd:string"/> <element name="relationtype" nillable="true" type="xsd:string"/> <element name="educationlevel" nillable="true" type="xsd:string"/> <element name="profession" nillable="true" type="xsd:string"/> <element name="incomesource" nillable="true" type="xsd:string"/> <element name="risklevel" nillable="true" type="xsd:string"/> <element name="clientstatus" nillable="true" type="xsd:string"/> <element name="clientclass" nillable="true" type="xsd:string"/> <element name="groupnumber" nillable="true" type="xsd:string"/> <element name="language" nillable="true" type="xsd:string"/> <element name="taxes" nillable="true" type="xsd:string"/> <element name="referby" nillable="true" type="xsd:string"/> <element name="referbyn" nillable="true" type="xsd:string"/> <element name="familiarrelationtype" nillable="true" <element name="resident" nillable="true" type="xsd:string"/> <element name="inquirylevel" nillable="true" type="xsd:string"/> <element name="discountcompanyname" nillable="true" type="xsd:string"/> <element name="position" nillable="true" type="xsd:string"/> <element name="employmenttime" nillable="true" type="xsd:string"/> <element name="companytype" nillable="true" type="xsd:string"/> <element name="currentjentrydate" nillable="true" type="xsd:string"/> <element name="previusjentrydate" nillable="true" type="xsd:string"/> <element name="currentincome" nillable="true" type="xsd:string"/> <element name="perrefname1" nillable="true" type="xsd:string"/> <element name="perrefstreet1" nillable="true" type="xsd:string"/> <element name="perrefbuildnum1" nillable="true" type="xsd:string"/> <element name="perrefhousenum1" nillable="true" type="xsd:string"/> <element name="perrefprovince1" nillable="true" type="xsd:string"/> <element name="perrefdistrit1" nillable="true" type="xsd:string"/> <element name="perrefcorreg1" nillable="true" type="xsd:string"/> <element name="perrefcountry1" nillable="true" type="xsd:string"/> <element name="perrefpobox1" nillable="true" type="xsd:string"/> <element name="perrefzipcode1" nillable="true" type="xsd:string"/> <element name="perrefphonenum1" nillable="true" type="xsd:string"/> <element name="perrefname2" nillable="true" type="xsd:string"/> <element name="perrefstreet2" nillable="true" type="xsd:string"/> <element name="perrefbuildnum2" nillable="true" type="xsd:string"/> <element name="perrefhousenum2" nillable="true" type="xsd:string"/> <element name="perrefprovince2" nillable="true" type="xsd:string"/> <element name="perrefdistrit2" nillable="true" type="xsd:string"/> <element name="perrefcorreg2" nillable="true" type="xsd:string"/> <element name="perrefcountry2" nillable="true" type="xsd:string"/> <element name="perrefpobox2" nillable="true" type="xsd:string"/> <element name="perrefzipcode2" nillable="true" type="xsd:string"/> <element name="perrefphonenum2" nillable="true" type="xsd:string"/> <element name="countrydesc" nillable="true" type="xsd:string"/> <element name="idtypedesc" nillable="true" type="xsd:string"/> <element name="provincedesc" nillable="true" type="xsd:string"/> <element name="nacionalitydesc" nillable="true" type="xsd:string"/> <element name="distritdesc" nillable="true" type="xsd:string"/> <element name="corregdesc" nillable="true" type="xsd:string"/> <element name="mainofficerdesc" nillable="true" type="xsd:string"/> <element name="secondofficerdesc" nillable="true" type="xsd:string"/> <element name="industrycodedesc" nillable="true" type="xsd:string"/> DATAPRO BUILDING 43

45 <element name="mainofficerdesc" nillable="true" type="xsd:string"/> <element name="secondofficerdesc" nillable="true" type="xsd:string"/> <element name="industrycodedesc" nillable="true" type="xsd:string"/> <element name="bussinescodedesc" nillable="true" type="xsd:string"/> <element name="residencycountrydesc" nillable="true" type="xsd:string"/ <element name="educationleveldsc" nillable="true" type="xsd:string"/ <element name="professiondesc" nillable="true" type="xsd:string"/> <element name="incomesourcedsc" nillable="true" type="xsd:string"/> <element name="riskleveldsc" nillable="true" type="xsd:string"/> <element name="companynamedsc" nillable="true" type="xsd:string"/> <element name="positiondsc" nillable="true" type="xsd:string"/> <element name="perrefprovince1dsc" nillable="true" type="xsd:string"/ <element name="perrefdistrit1dsc" nillable="true" type="xsd:string"/ <element name="perrefcorreg1dsc" nillable="true" type="xsd:string"/> <element name="perrefprovince2dsc" nillable="true" type="xsd:string"/ <element name="perrefdistrit2dsc" nillable="true" type="xsd:string"/> <element name="perrefcorreg2dsc" nillable="true" type="xsd:string"/> <element name="referbydsc" nillable="true" type="xsd:string"/> <element name="companyname" nillable="true" type="xsd:string"/> <element name="companyaddress" nillable="true" type="xsd:string"/> <element name="companyinfo" nillable="true" type="xsd:string"/> </sequence> </complextype> </schema> <schema elementformdefault="qualified" targetnamespace=" xmlns=" xmlns:impl=" xmlns:intf=" xmlns:tns2=" xmlns:wsdl=" xmlns:xsd=" <import namespace=" /> <element name="personalcustomerinquiry"> <complextype> <sequence> <element name="user" nillable="true" type="xsd:string"/> <element name="customerid" nillable="true" type="xsd:string"/> </sequence> </complextype> </element> <element name="personalcustomermaintenance"> <complextype> <sequence> <element name="personalcustomermaintenanceinput" nillable="true" type="tns2:personalcustmessage" /> </sequence> </complextype> </element> <element name="newpersonalcustomer"> <complextype> <sequence> <element name="newpersonalcustomerinput" nillable="true" type="tns2:personalcustmessage" /> </sequence> </complextype> DATAPRO BUILDING </element> 44

46 <element name="personalcustomerinquiryresponse"> <complextype> <sequence> <element name="personalcustomerinquiryreturn" nillable="true" type="tns2:personalcustmessage" /> </sequence> </complextype> </element> <element name="personalcustomermaintenanceresponse"> <complextype> <sequence> <element name="personalcustomermaintenancereturn" nillable="true" type="tns2:personalcustmessage" /> </sequence> </complextype> </element> <element name="newpersonalcustomerresponse"> <complextype> <sequence> <element name="newpersonalcustomerreturn" nillable="true" type="tns2:personalcustmessage" /> </sequence> </complextype> </element> <element name="errorbean"> <complextype> <sequence> <element name="message" nillable="true" type="xsd:string" /> </sequence> </complextype> </element> </schema> </wsdl:types> <wsdl:message name="personalcustomerinquiryrequest"> <wsdl:part element="impl:personalcustomerinquiry" name="parameters" /> </wsdl:message> <wsdl:message name="personalcustomerinquiryresponse"> <wsdl:part element="impl:personalcustomerinquiryresponse" name="parameters" /> </wsdl:message> <wsdl:message name="personalcustomermaintenancerequest"> <wsdl:part element="impl:personalcustomermaintenance" name="parameters" /> </wsdl:message> <wsdl:message name="personalcustomermaintenanceresponse"> <wsdl:part element="impl:personalcustomermaintenanceresponse" name="parameters" /> </wsdl:message> <wsdl:message name="newpersonalcustomerrequest"> <wsdl:part element="impl:newpersonalcustomer" name="parameters" /> </wsdl:message> DATAPRO BUILDING 45

47 <wsdl:message name="newpersonalcustomerresponse"> <wsdl:part element="impl:newpersonalcustomerresponse" name="parameters" /> </wsdl:message> <wsdl:message name="errormessage"> <wsdl:part name="validationerror" element="impl:errorbean"> </wsdl:part> </wsdl:message> <wsdl:porttype name="customerservices"> <wsdl:operation name="personalcustomerinquiry"> <wsdl:input message="impl:personalcustomerinquiryrequest" name="personalcustomerinquiryrequest" /> <wsdl:output message="impl:personalcustomerinquiryresponse" name="personalcustomerinquiryresponse" /> <wsdl:fault name="validationerror" message="impl:errormessage" /> </wsdl:operation> <wsdl:operation name="newpersonalcustomer"> <wsdl:input message="impl:newpersonalcustomerrequest" name="newpersonalcustomerrequest" /> <wsdl:output message="impl:newpersonalcustomerresponse" name="newpersonalcustomerresponse" /> <wsdl:fault name="validationerror" message="impl:errormessage" /> </wsdl:operation> <wsdl:operation name="personalcustomermaintenance"> <wsdl:input message="impl:personalcustomermaintenancerequest" name="personalcustomermaintenancerequest" /> <wsdl:output message="impl:personalcustomermaintenanceresponse" name="personalcustomermaintenanceresponse" /> <wsdl:fault name="validationerror" message="impl:errormessage" /> </wsdl:operation> </wsdl:porttype> <wsdl:binding name="customerservicessoapbinding" type="impl:customerservices"> <wsdlsoap:binding style="document" transport=" /> <wsdl:operation name="personalcustomerinquiry"> <wsdlsoap:operation soapaction="" /> <wsdl:input name="personalcustomerinquiryrequest"> <wsdlsoap:body use="literal" /> </wsdl:input> <wsdl:output name="personalcustomerinquiryresponse"> <wsdlsoap:body use="literal" /> </wsdl:output> <wsdl:fault name="validationerror"> <wsdlsoap:fault name="validationerror" use="literal" /> </wsdl:fault> </wsdl:operation> DATAPRO BUILDING 46

48 <wsdl:operation name="newpersonalcustomer"> <wsdlsoap:operation soapaction="" /> <wsdl:input name="newpersonalcustomerrequest"> <wsdlsoap:body use="literal" /> </wsdl:input> <wsdl:output name="newpersonalcustomerresponse"> <wsdlsoap:body use="literal" /> </wsdl:output> <wsdl:fault name="validationerror"> <wsdlsoap:fault name="validationerror" use="literal" /> </wsdl:fault> </wsdl:operation> <wsdl:operation name="personalcustomermaintenance"> <wsdlsoap:operation soapaction="" /> <wsdl:input name="personalcustomermaintenancerequest"> <wsdlsoap:body use="literal" /> </wsdl:input> <wsdl:output name="personalcustomermaintenanceresponse"> <wsdlsoap:body use="literal" /> </wsdl:output> <wsdl:fault name="validationerror"> <wsdlsoap:fault name="validationerror" use="literal" /> </wsdl:fault> </wsdl:operation> </wsdl:binding> <wsdl:service name="customerservice"> <wsdl:port binding="impl:customerservicessoapbinding" name="customerservices"> <wsdlsoap:address location=" /> </wsdl:port> </wsdl:service> </wsdl:definitions> DATAPRO BUILDING 47

49 DOCUMENTATION - CUSTOMER SERVICES CUSTOMER SERVICES 6. DEPLOYMENT: NAME TYPE FUNCTION Axis2 WAR Web Services Engine customerservice AAR Deployment File 7. COMPONENTS DEFINITION: NAME TYPE FUNCTION customerservice.wsdl WSDL Web Service Description CustomerServiceSkeleton JAVA Class for service impl. EWS000001Message JAVA Message Class. 8. FUNCTIONAL METHODS SUMMARY personalcustomerinquiry: Personal customer inquiry service. Parameters: o <user>- a String data type; sends the user that is soliciting the transaction.. o <customerid>- a String data type; sends the customer identification number. Returns: <PersonalCustMessage> - a data structure containing all the Customer data defined in the WSDL file. Error: <Validation Error> - Error message structure using an exception type errormessage defined in the WSDL file. personalcustomermaintenance: Personal customer maintenance service, it must include the customer number in the message. Parameters: <PersonalCustMessage> - a data structure containing all the customer data defined in the WSDL. Returns: <PersonalCustMessage> - a data structure containing all the customer data defined in the WSDL. Error: <Validation Error> - Error message structure using an exception type errormessage defined in the WSDL file. DATAPRO BUILDING 48

50 newpersonalcustomer: Personal customer creation service. The field customer number must be filled with zeros, the response message must return the new generated customer number. Parámetros: <PersonalCustMessage> - una estructura de datos compuesta con toda la data de cliente definida en el WSDL. Returns: <PersonalCustMessage> - a data structure containing all the customer data defined in the WSDL. Error: <Validation Error> - Error message structure using an exception type errormessage defined in the WSDL file. The error message is a SOAP message, never the less this message is generated only when an exception is thrown from the published method. This means that in the client side the error message will be obtain in a catch block. Currently the error its being sent in a String with the following form: <error code>-<error description> The error codes correspond to the same codes that are handled in the e-ibs system for form validations. The descriptions of some parameterized fields were added to the message, some of the codes that need description have fixed values, and the details about these values are summarized in the following table: FIELD DETAIL legalstatus 1=Single 2=Married, 3=Divorced, 4=Widow, 5=others Sex M=Male, F=Female relationtype 1 Regular Customer 2 Special 3 Employee 4 Functionary 5 Director 6 Relative 7 Affiliated Company 8 Directive Board 9 Corresponsal Bank clientstatus 1=active, 2=inactive, 3=Black list clienttype 1=corporation, 2=personal, 3=others clientclass 1= Governmental Entity, 2= Decentralized entity, N=Doesn t Apply language s=spanish e=english taxes Fixed values from 1 to 9 or N DATAPRO BUILDING 49

51 9. FUNCIONALIDAD To access the web services functionalities it s required to build a client, starting from the WSDL file attached to this document, the Web Service client in this case will be Ultimus, who will have to build the client in their application and who will exchange SOAP messages through http with Datapro s service that is published in the following URL: The WSDL file can be obtain through this URL: Here we present a small example of how to handle SOAP messages: Methods Signature PersonalCustMessage personalcustomerinquiry(string customerid); Where the complex type PersonalCustMessage is defined as PersonalCustMessage { String firstname; String secondname; String phonenumber; all the response fields } Request <?xml version="1.0" encoding="utf-8" standalone="no"?> <SOAP-ENV:Envelope SOAP- ENV:encodingStyle=" xmlns:soap-env=" xmlns:soap-enc=" xmlns:xsi=" xmlns:xsd=" <SOAP-ENV:Body> <ns1:personalcustomerinquiry xmlns:ns1="urn:mysoapservices"> <user xsi:type="xsd:string">bptdatapro</user> <customerid xsi:type="xsd:string"> </customerid> </ns1:personalcustomerinquiry> </SOAP-ENV:Body> </SOAP-ENV:Envelope> Response <?xml version="1.0" encoding="utf-8"?> DATAPRO BUILDING 50

52 <SOAP-ENV:Envelope xmlns:xsi=" xmlns:xsd=" xmlns:soap-env=" <SOAP-ENV:Body> <ns1: personalcustomerinquiryresponse xmlns:ns1="urn:mysoapservices" SOAP- ENV:encodingStyle=" <return xsi:type="ns1:personalcustmessage"> <firstname xsi:type="xsd:string">bill</firstname> <secondname xsi:type="xsd:string">gate</secondname> <phonenumber xsi:type="xsd:string"> </phonenumber> all the response fields </return> </ns1: personalcustomerinquiryresponse> </SOAP-ENV:Body> </SOAP-ENV:Envelope> With the WSDL file all the necessary elements to create the client to access the service can be generated. The WSDL file is attached below. DATAPRO BUILDING 51

53 DATAPRO BUILDING 52

54 10. ATTACHMENTS: <?xml version="1.0" encoding="utf-8"?> <wsdl:definitions targetnamespace=" xmlns:impl=" xmlns:intf=" xmlns:tns2=" xmlns:wsdl=" xmlns:wsdlsoap=" xmlns:xsd=" <wsdl:types> <schema elementformdefault="qualified" targetnamespace=" xmlns=" xmlns:impl=" xmlns:intf=" xmlns:wsdl=" xmlns:xsd=" <complextype name="personalcustmessage"> <sequence> <element name="user" nillable="true" type="xsd:string"/> <element name="idnumber" nillable="true" type="xsd:string"/> <element name="clienttype" nillable="true" type="xsd:string"/> <element name="idcountry" nillable="true" type="xsd:string"/> <element name="idtype" nillable="true" type="xsd:string"/> <element name="customernumber" nillable="true" type="xsd:string"/> <element name="firstname" nillable="true" type="xsd:string"/> <element name="secondname" nillable="true" type="xsd:string"/> <element name="firstlastname" nillable="true" type="xsd:string"/> <element name="secondlastname" nillable="true" type="xsd:string"/> <element name="marriedname" nillable="true" type="xsd:string"/> <element name="legalname" nillable="true" type="xsd:string"/> <element name="shortname" nillable="true" type="xsd:string"/> <element name="dependents" nillable="true" type="xsd:string"/> <element name="sex" nillable="true" type="xsd:string"/> <element name="legalstatus" nillable="true" type="xsd:string"/> <element name="nacionality" nillable="true" type="xsd:string"/> <element name="street" nillable="true" type="xsd:string"/> <element name="housenumber" nillable="true" type="xsd:string"/> <element name="province" nillable="true" type="xsd:string"/> <element name="distrit" nillable="true" type="xsd:string"/> <element name="correg" nillable="true" type="xsd:string"/> <element name="country" nillable="true" type="xsd:string"/> <element name="pobox" nillable="true" type="xsd:string"/> <element name="zipcode" nillable="true" type="xsd:string"/> <element name=" " nillable="true" type="xsd:string"/> <element name="birthdate" nillable="true" type="xsd:string"/> <element name="firstcontactdate" nillable="true" type="xsd:string"/> <element name="housephonenum" nillable="true" type="xsd:string"/> <element name="officephonenum" nillable="true" type="xsd:string"/> <element name="celularphonenum" nillable="true" type="xsd:string"/> <element name="faxnumber" nillable="true" type="xsd:string"/> <element name="mainofficer" nillable="true" type="xsd:string"/> <element name="secondofficer" nillable="true" type="xsd:string"/> <element name="industrycode" nillable="true" type="xsd:string"/> DATAPRO BUILDING <element name="businesscode" nillable="true" type="xsd:string"/> 53