Manual del Usuario Externo. wgespagosliq. Versión Preliminar. Pagos de liquidaciones aduaneras Fecha: 05/07/2017

Transcripción

1 wgespagosliq Pagos de liquidaciones aduaneras Fecha: 05/07/2017 Versión Preliminar

2 Historial de modificaciones Fecha Versión Descripción Autor / Área 05/07/ Versión inicial del documento Leopoldo Revisión

3 CONTENIDO FINALIDAD... 4 CONDICIONES NECESARIAS PARA LA AUTENTICACION DEL USUARIO... 4 DOCUMENTACION ADICIONAL... 4 METODO CONSULTARGARANTIAS... 5 METODO CONSUTARSUBCUENTAS... 6 METODO CONSULTARLIQUIDACION... 7 METODO PAGARLIQUIDACION... 9

4 DOCUMENTO FUNCIONAL FINALIDAD Brindar soporte a los usuarios externos para poder probar sus aplicativos invocando el Web Service wgespagosliq en el ambiente de homologación de forma autónoma. CONDICIONES NECESARIAS PARA LA AUTENTICACION DEL USUARIO Para poder invocar al WS, AFIP cuenta con otro WS de autenticación donde previamente deberá gestionar el ticket de Conexión con el cual será validado el ingreso al WS de negocio. La información de cómo gestionar el ticket y los certificados correspondientes se encuentran en el siguiente link: - WSAA - WebService de Autenticación y Autorización: Nota aclaratoria: Tener en cuenta que el certificado generado debe ser utilizado con el CUIT provisto oportunamente por la DI INAD. Una vez que se haya generado el certificado y en caso de que se deba delegar el permiso de acceso a otro CUIT deberá realizar la delegación del Web Service AFIP con el Administrador de Relaciones a través de la clave fiscal. Esta información se encuentra en: - El Manual del usuario del WSASS : Por cualquier consulta referida al proceso de Autenticación y Autorización de WS en el ambiente de homologación dirigir mail a la siguiente dirección de correo: webservices-desa@afip.gob.ar Para poder operar en el ambiente de homologación el usuario debe: - Ser una empresa habilitada para operar: IMEX Importador/Exportador IEOC Importador/Exportador ocasional DESP Despachante USUD Usuarios Directos - Ser una empresa que aun no tenga esa caracterización, en cuyo caso deben solicitar un cuit valido e inexistente de homologación que tenga ese tipo de agente DOCUMENTACION ADICIONAL El manual del desarrollador al que haremos referencia en el presente documento se encuentra en el siguiente micrositio. - Más específicamente en Catálogo de otros WS de negocio disponibles - Aduana. METODOS WEB 4

5 METODO ConsultarGarantías: Este método tiene como objeto retornar información de garantías con saldo disponible (mayor a cero) que puedan ser utilizadas para el pago de la liquidación. El XML de entrada con que se accederá a esta información se completa de la siguiente manera: <ar:consultargarantias> <ar:argwsautenticacionempresa> <ar:token>...</ar:token> <ar:sign>...</ar:sign> <ar:cuitempresaconectada> </ar:cuitempresaconectada> <ar:tipoagente>imex</ar:tipoagente> <ar:rol>desp</ar:rol> </ar:argwsautenticacionempresa> <ar:argconsultargarantiasparams> <ar:cuitimex> </ar:cuitimex> <ar:cuitdesp> </ar:cuitdesp> <ar:titulartipodoc></ar:titulartipodoc> <ar:titularnrodoc></ar:titularnrodoc> <ar:idgarantia></ar:idgarantia> <ar:aduana></ar:aduana> <ar:motivo></ar:motivo> <ar:fecdesde> t01:25:00-03:00</ar:fecdesde> <ar:fechasta> t01:25:00-03:00</ar:fechasta> </ar:argconsultargarantiasparams> </ar:consultargarantias> - Para el tag CuitEmpresaConectada completar columna b fila 3 del archivo excel - Para el tag TipoAgente completar columna a fila 3 del archivo excel - Para el tag Rol completar columna a fila 4 del archivo excel - Para el tag cuitimex completar columna b fila 3 del archivo excel - Para el tag cuitdesp completar columna b fila 4 del archivo excel - Para el tag idgarantia completar columna b fila 10 del archivo excel La ejecución del XML de entrada nos devolverá un XML de respuesta, nutrido de la información correspondiente a la declaración que se consulta. <ConsultarGarantiasResponse xmlns="ar.gov.afip.dia.serviciosweb.wgespagosliq"> <ConsultarGarantiasResult> <ListaErrores> <DetalleError> <Codigo>0</Codigo> <Descripcion>Ejecucion exitosa.</descripcion> <DescripcionAdicional/> </DetalleError> </ListaErrores> <listainfogarantias> <InfoGarantia> <idgarantia> b</idgarantia> <clase>glo</clase> <tipo>efvo</tipo> 5

6 <motivo>dump</motivo> <aduana>033</aduana> <estado>con</estado> <moneda>dol</moneda> <feccreacion> t00:00:00</feccreacion> <monto>150</monto> <saldo>150</saldo> </InfoGarantia> </listainfogarantias> </ConsultarGarantiasResult> </ConsultarGarantiasResponse> Las estructuras son repetitivas, las mismas tienen una ocurrencia entre 1:xxx veces para mostrar la totalidad de la información de cada garantía. Para mas información remitirse al Manual del Desarrollador, WebService wgespagosliq Pago de liquidaciones aduaneras MÉTODOS B) CONSULTARGARANTIAS Casos para consultar para este método. Se proporcionara a cada empresa en formato xls los casos de prueba METODO ConsultarSubcuentas: Este método tiene como objeto retornar información de subcuentas con saldo disponible (mayor a cero) que puedan ser utilizadas para el pago de la liquidación. El XML de entrada con que se accederá a esta información se completa de la siguiente manera: <ar:consultarsubcuentas> <ar:argwsautenticacionempresa> <ar:token>...</ar:token> <ar:sign>...</ar:sign> <ar:cuitempresaconectada> </ar:cuitempresaconectada> <ar:tipoagente>desp</ar:tipoagente> <ar:rol>desp</ar:rol> </ar:argwsautenticacionempresa> <ar:argconsultarsubcuentasparams> <ar:cuitimex> </ar:cuitimex> <ar:cuitdesp> </ar:cuitdesp> <ar:titulartipodoc></ar:titulartipodoc> <ar:titularnrodoc></ar:titularnrodoc> <ar:idsubcuenta></ar:idsubcuenta> <ar:tipo></ar:tipo> <ar:fecdesde> t01:25:00-03:00</ar:fecdesde> <ar:fechasta> t01:25:00-03:00</ar:fechasta> </ar:argconsultarsubcuentasparams> </ar:consultarsubcuentas> - Para el tag CuitEmpresaConectada completar columna b fila 3 del archivo excel 6

7 - Para el tag TipoAgente completar columna a fila 3 del archivo excel - Para el tag Rol completar columna a fila 4 del archivo excel - Para el tag cuitimex completar columna b fila 3 del archivo excel - Para el tag cuitdesp completar columna b fila 4 del archivo excel - Para el tag idsubcuenta completar columna b fila 24 del archivo excel La ejecución del XML de entrada nos devolverá un XML de respuesta, nutrido de la información correspondiente a la declaración que se consulta. < <idsubcuenta>17000pesvp </idsubcuenta> <fecacreditacion> t15:30:01</fecacreditacion> <monto> </monto> <saldo> </saldo> </InfoSubcuenta>> Las estructuras son repetitivas, las mismas tienen una ocurrencia entre 1:xxx veces para mostrar la totalidad de la información de cada garantía. Para mas información remitirse al Manual del Desarrollador, WebService wgespagosliq Pago de liquidaciones aduaneras MÉTODOS A) CONSULTARSUBCUENTAS Casos para consultar para este método. Se proporcionara a cada empresa en formato xls los casos de prueba METODO ConsultarLiquidacion: Este método tiene como objeto retornar información básica de liquidaciones con estado En Curso (ENC) que luego se podrán pagar utilizando el método PagarLiquidacion. El XML de entrada con que se accederá a esta información se completa de la siguiente manera: <ar:consultarliquidaciones> <ar:argwsautenticacionempresa> <ar:token>...</ar:token> <ar:sign>...</ar:sign> <ar:cuitempresaconectada> </ar:cuitempresaconectada> <ar:tipoagente>desp</ar:tipoagente> <ar:rol>desp</ar:rol> </ar:argwsautenticacionempresa> 7

8 <ar:argconsultarliquidacionesparams> <ar:cuitimex> </ar:cuitimex> <ar:cuitdesp> </ar:cuitdesp> <ar:titulartipodoc></ar:titulartipodoc> <ar:titularnrodoc></ar:titularnrodoc> <ar:idliquidacion>17033lman000207t</ar:idliquidacion> <ar:tipdocreferencia></ar:tipdocreferencia> <ar:nrodocreferencia></ar:nrodocreferencia> <ar:motivo></ar:motivo> <ar:fecdesde> t01:25:00-03:00</ar:fecdesde> <ar:fechasta> t01:25:00-03:00</ar:fechasta> </ar:argconsultarliquidacionesparams> </ar:consultarliquidaciones> - Para el tag CuitEmpresaConectada completar columna b fila 3 del archivo excel - Para el tag TipoAgente completar columna a fila 3 del archivo excel - Para el tag Rol completar columna a fila 4 del archivo excel - Para el tag cuitimex completar columna b fila 3 del archivo excel - Para el tag cuitdesp completar columna b fila 4 del archivo excel - Para el tag idliquidacion completar columna b fila 34 del archivo excel La ejecución del XML de entrada nos devolverá un XML de respuesta, nutrido de la información correspondiente a la declaración que se consulta. <ConsultarLiquidacionesResponse xmlns="ar.gov.afip.dia.serviciosweb.wgespagosliq"> <ConsultarLiquidacionesResult> <ListaErrores> <DetalleError> <Codigo>0</Codigo> <Descripcion>Ejecucion exitosa.</descripcion> <DescripcionAdicional/> </DetalleError> </ListaErrores> <listaliquidaciones> <InfoLiquidacion> <idliquidacion>17033lman000207t</idliquidacion> <tipodocreferencia>otr</tipodocreferencia> <nrodocreferencia>liquidacion 1</nroDocReferencia> <fecha> t00:00:00</fecha> <motivo>reli</motivo> <fecvencimiento> t00:00:00</fecvencimiento> <estado>enc</estado> <montopagdol>105.42</montopagdol> <montopagpes> </montopagpes> <montogardol>0</montogardol> <listaconceptos> <InfoConcepto> <concepto>043</concepto> <tipo>p</tipo> <monto>105.42</monto> <fecvencimiento> t00:00:00</fecvencimiento> </InfoConcepto> </listaconceptos> </InfoLiquidacion> 8

9 </listaliquidaciones> </ConsultarLiquidacionesResult> </ConsultarLiquidacionesResponse> Las estructuras son repetitivas, las mismas tienen una ocurrencia entre 1:xxx veces para mostrar la totalidad de la información de cada garantía. Para mas información remitirse al Manual del Desarrollador, WebService wgespagosliq Pago de liquidaciones aduaneras MÉTODOS C) CONSULTARLIQUIDACIONES Casos para consultar para este método Se proporcionara a cada empresa en formato xls los casos de prueba METODO PagarLiquidacion: Este es el método que se utiliza para la afectación de subcuentas y garantías en el pago de una liquidación manual o automática. Dentro del grupo de liquidaciones automáticas se encuentran las liquidaciones provenientes de oficializaciones. El XML de entrada con que se accederá a esta información se completa de la siguiente manera: <ar:pagarliquidacion> <ar:argwsautenticacionempresa> <ar:token>...</ar:token> <ar:sign>...</ar:sign> <ar:cuitempresaconectada> </ar:cuitempresaconectada> <ar:tipoagente>desp</ar:tipoagente> <ar:rol>desp</ar:rol> </ar:argwsautenticacionempresa> <ar:argpagarliquidacionparams> <ar:cuitimex> </ar:cuitimex> <ar:cuitdesp> </ar:cuitdesp> <ar:titulartipodoc></ar:titulartipodoc> <ar:titularnrodoc></ar:titularnrodoc> <ar:idliquidacion>17033lman000207t</ar:idliquidacion> <ar:listasubcuentas> <ar:subcuentaaafectar> <ar:idsubcuenta17000pesvp </ar:idsubcuenta> <ar:importe>1700</ar:importe> </ar:subcuentaaafectar> </ar:listasubcuentas> <ar:transaccion> </ar:transaccion> </ar:argpagarliquidacionparams> </ar:pagarliquidacion> 9

10 - Para el tag CuitEmpresaConectada completar columna b fila 3 del archivo excel - Para el tag TipoAgente completar columna a fila 3 del archivo excel - Para el tag Rol completar columna a fila 4 del archivo excel - Para el tag cuitimex completar columna b fila 3 del archivo excel - Para el tag cuitdesp completar columna b fila 4 del archivo excel - Para el tag idliquidacion completar columna b fila 34 del archivo excel - Para el tag idsubcuenta completar columna b fila 24 del archivo excel La ejecución del XML de entrada nos devolverá un XML de respuesta, en caso de afectar el pago devolverá Ejecución Exitosa <PagarLiquidacionResponse xmlns="ar.gov.afip.dia.serviciosweb.wgespagosliq"> <PagarLiquidacionResult> <ListaErrores> <DetalleError> <Codigo>0</Codigo> <Descripcion>Ejecucion exitosa.</descripcion> <DescripcionAdicional/> </DetalleError> </ListaErrores> </PagarLiquidacionResult> </PagarLiquidacionResponse> Las estructuras son repetitivas, las mismas tienen una ocurrencia entre 1:xxx veces para mostrar la totalidad de la información de cada garantía. Para mas información remitirse al Manual del Desarrollador, WebService wgespagosliq Pago de liquidaciones aduaneras MÉTODOS D) PAGARLIQUIDACION Casos para consultar para este método. Se proporcionara a cada empresa en formato xls los casos de prueba. Para este metodo en caso de requerir un rollback de los casos indicarlo por correo. 10