Manual Del Desarrollador Wgescouparticulares 230302 152653

Manual del Desarrollador
wgescouparticulares
Gestión de los Courier para envíos postales

internacionales particulares
Fecha: 25/06/2019
Historial de Cambios
Fecha Versión Descripción Autor / Área Revisión
25/06/2019 1.0 Versión inicial SLACRUZ / DIDESA
CONTENIDO
INTRODUCCIÓN........................................................................................................................................................................4
WS DE NEGOCIO.......................................................................................................................................................................7
WEBSERVICE WGESCOUPARTICULARES
MANUAL DEL DESARROLLADOR
Gestión de los Courier para envíos postales internacionales particulares
INTRODUCCIÓN
OBJETIVO Y ALCANCE
El objetivo de este Web Service es brindar funcionalidad a los Courier para la gestión relacionada con los envíos postales
internacionales particulares.
El alcance de este Web Service es brindar la funcionalidad necesaria para la confirmación de entrega de los envíos postales
internacionales particulares.
Web Service Tema WebMethod

ConfirmarEnvio
Confirmación de entrega de un
ConsultarEnvioNoConfirmado
envío
wgescouparticulares
Datos del consignatario ConsultarDomicilioFiscalyCupo
PRERREQUISITOS
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 la sección DOCUMENTACION
de www.afip.gob.ar/ws".
Las consultas acerca del WSAA hay que dirigirlas a webservices-desa@afip.gob.ar.
TERMINOLOGÍA Y ACRÓNIMOS
PSP: Empresa de Courier

WS: Web Service
WM: Web Method
Consignatario: destinatario del envío en una importación.
ESPECIFICACIONES DEL SERVICIO
Nombre wgescouparticulares
NameSpace Ar.Gob.Afip.Dga.wgescouparticulares
URL Testing https://wsaduhomoext.afip.gob.ar/diav2/wgescouparticulares
4
URL Producción https://webservicesadu.afip.gob.ar/DIAV2/wgescouparticulares

Parámetro Tipo
Parámetros de Entrada argWSAutenticacionEmpresa WSAutenticacionEmpresa
ConfirmarEnvio argConfirmarEnvio ConfirmarEnvioParam
Resultado de Salida ConfirmarEnvioRta
Permite que el Courier informe a la aduana el envío que fue entregado al consignatario
Parámetro Tipo
ConsultarEnvioNoConfirmado argConsultarEnvioNoConfirmado ConsultarEnvioNoConfirmadoParam
Resultado de Salida ConsultarEnvioNoConfirmadoRta
Permite consultar para un CUIT/CUIL/CDI y numero de track si el envío fue entregado al consignatario
Parámetro Tipo
ConsultarDomicilioFiscalyCupo argConsultarDomicilioFiscalyCupo ConsultarDomicilioFiscalyCupoParam

Resultado de Salida ConsultarDomicilioFiscalyCupoRta
Permite consultar si el CUIT/CUIL/CDI del consignatario posee domicilio fiscal electrónico declarado.
Además verifica si posee cupos para poder concretar la recepción del envío.
Resultado de Estructura ResultadoEjecucionDummy
Salida
Dummy
Devuelve variables que determinan el correcto funcionamiento del web service (conectividad con la base
de datos, respuesta desde el servidor y correcto funcionamiento del servidor de tickets).
5
PROPIEDADES DE LA ESTRUCTURA AUTENTICACION
A excepción del método Dummy, cada método del web service tiene dos parámetros, uno para la autenticación y autorización;
y otro con la información propia de cada método en particular.
Con respecto al primero, sus características son siempre las mismas y se detallan a continuación:
Autenticacion
Información para la autenticación y autorización.
ATRIBUTO DESCRIPCIÓN TIPO OBL OBSERVACIONES
Token Token retornado por el WSAA - S
Sign Firma retornada por el WSAA - S
Cuit Cuit de la empresa representada String(11) S
TipoAgente Código del tipo de agente que se conecta String(4) S “COUR” (Courier)
Rol Rol String(4) S “COUR” (Courier)
TABLAS DE REFERENCIA
Aquellos datos que corresponden a códigos incluidos en tablas de referencia deben ser consultados utilizando el webservice
wgesTabRef que contiene la información actualizada de los códigos disponibles para cada tabla citada en particular.
6
WS DE NEGOCIO
MÉTODOS
Este Web Service, permitirá a los Courier gestionar los envíos particulares a consignatarios con Domicilio Fiscal
Electrónico declarado.
A) ConfirmarEnvio
Descripción
Este Web Method permite al Courier confirmar a la aduana la entrega de un envío particular al consignatario.
Estructura del método
<?xml version="1.0" encoding="utf-8"?>

<soap12:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns:soap12="http://www.w3.org/2003/05/soap-envelope">
<soap12:Body>
<ConfirmarEnvio xmlns="Ar.Gob.Afip.Dga.wgescouparticulares">
<argWSAutenticacionEmpresa>
<CuitEmpresaConectada>long</CuitEmpresaConectada>
<TipoAgente>string</TipoAgente>
<Rol>string</Rol>
</argWSAutenticacionEmpresa>
<TipoDocumentoConsignatario>string</TipoDocumentoConsignatario>
<NumeroDocumentoConsignatario>string</NumeroDocumentoConsignatario>
<NumeroTrack>string</NumeroTrack>
<NumeroParticular>string</NumeroParticular>
<FechaEntrega>dateTime</FechaEntrega>
</argConfirmarEnvio>
</ConfirmarEnvio>
</soap12:Body>
</soap12:Envelope>

<soap12:Body>
<ConfirmarEnvioResponse xmlns="Ar.Gob.Afip.Dga.wgescouparticulares">
<ConfirmarEnvioResult />
</ConfirmarEnvioResponse>
</soap12:Body>
</soap12:Envelope>
7
Parámetros de entrada
PARAMETRO DESCRIPCIÓN TIPO

argWSAutenticacionEmpresa Información para la conexión. WSAutenticacionEmpresa
argConfirmarEnvio Parámetros específicos del método. ConfirmarEnvioParam
Respuesta del método
DESCRIPCIÓN TIPO
Incluye la información del resultado de la ejecución (código y descripción del error) ConfirmarEnvioRta
Ejemplos XML
 Entrada
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:ar="Ar.Gob.Afip.Dga.wgescouparticulares">
<soapenv:Header/>
<soapenv:Body>
<ar:ConfirmarEnvio>
<ar:argWSAutenticacionEmpresa>
<ar:Token>PD94b……gICA8L29wZXJhdGlvbj4KPC9zc28+Cg==</ar:Token>
<ar:Sign>R0vYZ8G……thoH1OAOKK7mDzGLZP/CLGbdLOwE8=</ar:Sign>
<ar:CuitEmpresaConectada>20040410024</ar:CuitEmpresaConectada>
<ar:TipoAgente>IMEX</ar:TipoAgente>
<ar:Rol>IMEX</ar:Rol>
</ar:argWSAutenticacionEmpresa>
<ar:argConfirmarEnvio>
<ar:TipoDocumentoConsignatario>CUIT</ar:TipoDocumentoConsignatario>
<ar:NumeroDocumentoConsignatario>20040410024</ar:NumeroDocumentoConsignatario>
<ar:NumeroTrack>234</ar:NumeroTrack>
<ar:NumeroParticular>234</ar:NumeroParticular>
<ar:FechaEntrega>2019-07-13T00:00:00-03:00</ar:FechaEntrega>
</ar:argConfirmarEnvio>
</ar:ConfirmarEnvio>
</soapenv:Body>
</soapenv:Envelope>
 Salida
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/" xmlns:xsi="http://www.w3.org/2001/XMLSchema-

instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema">
<soap:Body>
<ConfirmarEnvioResponse xmlns="Ar.Gob.Afip.Dga.wgesepi">
<ConfirmarEnvioResult>
<ListaErrores>
<DetalleError>
<Codigo>0</Codigo>
8
<Descripcion>Ejecucion Exitosa</Descripcion>
<DescripcionAdicional/>
</DetalleError>
</ListaErrores>
<Server>127.0.0.1</Server>
<TimeStamp>2019-06-08T08:35:10.7873841-03:00</TimeStamp>
</ConfirmarEnvioResult>
</ConfirmarEnvioResponse>
</soap:Body>
</soap:Envelope>
B) ConsultarDomicilioFiscalyCupo
Descripción
Este Web Method permite al Courier consultar si un consignatario tiene el Domicilio Fiscal Electrónico declarado y
el cupo disponible para el mismo.

<soap12:Body>
<ConsultarDomicilioFiscalyCupo xmlns="Ar.Gob.Afip.Dga.wgescouparticulares">
<Rol>string</Rol>
<argConsultarDomicilioFiscalyCupo>
</argConsultarDomicilioFiscalyCupo> </ConsultarDomicilioFiscalyCupo>
</soap12:Body>
</soap12:Envelope>

<soap12:Body>
<ConsultarDomicilioFiscalyCupoResponse xmlns="Ar.Gob.Afip.Dga.wgescouparticulares">
<ConsultarDomicilioFiscalyCupoResult>
<PoseeDomicilioFiscalElectronico>string</PoseeDomicilioFiscalElectronico>
<CantidadCuposDisponibles>int</CantidadCuposDisponibles>
<FechaFallecimiento>dateTime</FechaFallecimiento>
9
</ConsultarDomicilioFiscalyCupoResult>
</ConsultarDomicilioFiscalyCupoResponse>>
</soap12:Body>
</soap12:Envelope>

argConsultarDomicilioFiscalyCupo Parámetros específicos del método. ConsultarDomicilioFiscalyCupoParam
DESCRIPCIÓN TIPO
Incluye la información del resultado de la ejecución (código y descripción del error) ConsultarDomicilioFiscalyCupoRta
Ejemplos XML
 Entrada
<soapenv:Header/>
<soapenv:Body>
<ar:ConsultarDomicilioFiscalyCupo>

<ar:Token>PD94bWwgd……A8L29wZXJhdGlvbj4KPC9zc28+Cg==</ar:Token>
<ar:Sign>R0vYZ8Gbrjg7……H1OAOKK7mDzGLZP/CLGbdLOwE8=</ar:Sign>
<ar:argConsultarDomicilioFiscalyCupo>
</ar:argConsultarDomicilioFiscalyCupo>
</ar:ConsultarDomicilioFiscalyCupo>
</soapenv:Body>
</soapenv:Envelope>
 Salida
10

<soap:Body>
<ConsultarDomicilioFiscalyCupoResponse xmlns="Ar.Gob.Afip.Dga.wgescouparticulares">
<ConsultarDomicilioFiscalyCupoResult>
<ListaErrores>
<DetalleError>
<Codigo>0</Codigo>
</DetalleError>
</ListaErrores>
<CantidadCuposDisponibles>0</CantidadCuposDisponibles>
</ConsultarDomicilioFiscalyCupoResult>
</ConsultarDomicilioFiscalyCupoResponse></soap:Body>
</soap:Envelope>
C) ConsultarEnvioNoConfirmado
Descripción
Este Web Method permite al Courier consultar si un envío en particular fue confirmado o no.

<soap12:Body>
<ConsultarEnvioNoConfirmado xmlns="Ar.Gob.Afip.Dga.wgescouparticulares">
<Rol>string</Rol>
<argConsultarEnvioNoConfirmado>
<NumeroTrack>string</NumeroTrack>
<NumeroParticular>string</NumeroParticular>
</argConsultarEnvioNoConfirmado>
</ConsultarEnvioNoConfirmado>
</soap12:Body>
</soap12:Envelope>
11

<soap12:Body>
<ConsultarEnvioNoConfirmadoResponse xmlns="Ar.Gob.Afip.Dga.wgescouparticulares">
<ConsultarEnvioNoConfirmadoResult>
<EnvioConfirmado>string</EnvioConfirmado>
</ConsultarEnvioNoConfirmadoResult>
</ConsultarEnvioNoConfirmadoResponse>
</soap12:Body>
</soap12:Envelope>

ConsultarEnvioNoConfirmadoParam Parámetros específicos del método. argConsultarEnvioNoConfirmado
DESCRIPCIÓN TIPO
Incluye la información del resultado de la ejecución (código y descripción del error) ConsultarEnvioNoConfirmadoRta
Ejemplos XML
 Entrada
<soapenv:Header/>
<soapenv:Body>
<ar:ConsultarEnvioNoConfirmado>

<ar:Token>PD94bWwgdmVy……lvbj4KPC9zc28+Cg==</ar:Token>
<ar:Sign>R0vYZ8Gbrjg7……LZP/CLGbdLOwE8=</ar:Sign>
<ar:argConsultarEnvioNoConfirmado>
<ar:NumeroTrack>123456789</ar:NumeroTrack>
<ar:NumeroParticular>19033PART000001X</ar:NumeroParticular>
12
</ar:argConsultarEnvioNoConfirmado>
</ar:ConsultarEnvioNoConfirmado>
</soapenv:Body>
</soapenv:Envelope>
 Salida

<soap:Body>
<ConsultarEnvioNoConfirmadoResponse xmlns="Ar.Gob.Afip.Dga.wgescouparticulares">
<ConsultarEnvioNoConfirmadoResult>
<ListaErrores>
<DetalleError>
<Codigo>0</Codigo>
</DetalleError>
</ListaErrores>
</ConsultarEnvioNoConfirmadoResult>
</ConsultarEnvioNoConfirmadoResponse>
</soap:Body>
</soap:Envelope>
D) DUMMY
Descripción
Método Dummy para verificación de funcionamiento. Utilizando este método se accede a la verificación del
funcionamiento de la infraestructura con respecto a:
 Servidor de Aplicación.
 Servidor de Ticket.
 Servidor de Base de Datos.
El método no recibe parámetros.
public ResultadoEjecucionDummy Dummy()
<ResultadoEjecucionDummy>
..<appserver>String</appserver>
13
..<dbserver>String</dbserver>
..<authserver>String</authserver>
</ResultadoEjecucionDummy>
ResultadoEjecucionDummy
Información del estado de la conexión
ATRIBUTO DESCRIPCIÓN TIPO
Respuesta Servidor de Aplicación.
Appserver String
“OK” correcto, “NO” en caso contrario
Respuesta Servidor de Base de Datos.
Dbserver String
Respuesta Servidor de Ticket.
AuthServer String
CÓDIGOS Y MENSAJES DE ERROR

1) Errores del Negocio
Errores comunes a todos los metodos
NRO DE ERROR DESCRIPCION DEL MENSAJE OBSERVACIONES

42034 Falta el dato obligatorio Cuit del Courier
42075 Campo Cuit del Courier, longitud inválida 11
42034 Falta el dato obligatorio Cuit del Consignatario
42075 Campo Cuit del Consignatario, longitud inválida
11
21248 Declaración inexistente o invalida
20752 El dígito verificador de la destinación es inco-
rrecto
ConfirmarEnvio

31706 El numero de envio no se corresponde con la
particular
12628 RELACION ENTRE LA DECLARACION PARTICULAR
Y EL PSP INEXISTENTE
ConsultarDomicilioFiscalyCupo

12663 Domicilio Fiscal Electronico no declarado
14
31707 Consignatario inexistente
ConsultarEnvioNoConfirmado

31706 El numero de envio no se corresponde con la
particular
12628 RELACION ENTRE LA DECLARACION PARTICULAR
Y EL PSP INEXISTENTE
2) Errores de Autenticación
CÓDIGO DESCRIPCIÓN
6005 CUIT,CUIL y/o tipo de agente invalido para el servicio
6006 Rol invalido para el tipo de agente y el servicio solicitado
6007 Aduana invalida para el CUIT y el tipo de agente informados
6008 Lugar operativo invalido para el CUIT y la aduana informados

6009 Aduana invalida para el domicilio CUIT/tipo agente
7000 El mensaje de error fue resuelto en el aplicativo
7001 No se encontró la empresa conectada en la lista de empresas del token
7006 Debe ingresar la firma
7007 Debe ingresar el token
7008 token inválido. El Token no se encuentra en formato base 64
7008 token inválido. El Token no se encuentra bien conformado
7008 token inválido. El token no tiene un tipo de usuario definido
7008 token inválido. Fallo la autenticacion del token
7013 El Servicio no se corresponde con el Token
7015 Cuit con el que desea operar no informado
7016 Tipo Agente con el que desea operar no informado
7017 Rol con el que desea operar no informado
42034 Falta el dato obligatorio argWSAutenticacionEmpresa
42034 Falta el dato obligatorio Aduana
42034 Falta el dato obligatorio Lugar Operativo
Falta el dato obligatorio xxxxx
42034
Si falta algún atributo/Parámetro obligatorio
15

Manual Del Desarrollador Wgescouparticulares 230302 152653

Cargado por

Información del documento

Título original

Derechos de autor

Formatos disponibles

Compartir este documento

Compartir o incrustar documentos

Opciones para compartir

¿Le pareció útil este documento?

¿Este contenido es inapropiado?

Copyright:

Formatos disponibles

Manual Del Desarrollador Wgescouparticulares 230302 152653

Cargado por

Copyright:

Formatos disponibles

Manual del Desarrollador

Gestión de los Courier para envíos postales

Web Service Tema WebMethod

Las consultas acerca del WSAA hay que dirigirlas a webservices-desa@afip.gob.ar.

PSP: Empresa de Courier

ESPECIFICACIONES DEL SERVICIO

URL Testing https://wsaduhomoext.afip.gob.ar/diav2/wgescouparticulares

URL Producción https://webservicesadu.afip.gob.ar/DIAV2/wgescouparticulares

ConsultarDomicilioFiscalyCupo argConsultarDomicilioFiscalyCupo ConsultarDomicilioFiscalyCupoParam

PROPIEDADES DE LA ESTRUCTURA AUTENTICACION

Estructura del método

<?xml version="1.0" encoding="utf-8"?>

<?xml version="1.0" encoding="utf-8"?>

PARAMETRO DESCRIPCIÓN TIPO

Respuesta del método

<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/" xmlns:xsi="http://www.w3.org/2001/XMLSchema-

Estructura del método

<?xml version="1.0" encoding="utf-8"?>

<?xml version="1.0" encoding="utf-8"?>

PARAMETRO DESCRIPCIÓN TIPO

Respuesta del método

<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/" xmlns:xsi="http://www.w3.org/2001/XMLSchema-

Estructura del método

<?xml version="1.0" encoding="utf-8"?>

<?xml version="1.0" encoding="utf-8"?>

PARAMETRO DESCRIPCIÓN TIPO

Respuesta del método

<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/" xmlns:xsi="http://www.w3.org/2001/XMLSchema-

El método no recibe parámetros.

public ResultadoEjecucionDummy Dummy()

Respuesta del método

CÓDIGOS Y MENSAJES DE ERROR

Errores comunes a todos los metodos

NRO DE ERROR DESCRIPCION DEL MENSAJE OBSERVACIONES

NRO DE ERROR DESCRIPCION DEL MENSAJE OBSERVACIONES

NRO DE ERROR DESCRIPCION DEL MENSAJE OBSERVACIONES

31707 Consignatario inexistente

NRO DE ERROR DESCRIPCION DEL MENSAJE OBSERVACIONES

6008 Lugar operativo invalido para el CUIT y la aduana informados

También podría gustarte