WSCTGv4.0

El WSCTGv4.0 es un nuevo web service publicado por AFIP (desde el 01/06/2017).

Este nuevo web service WSCTGv4.0 mantiene toda la estructura de métodos y propiedades del WSCTGV3 (yV1) con algunos pequeños cambios de propiedades y métodos. En especial para el manejo del campo turno (o cupo).

Es decir que con un instalador de la interfaz que conecte al WSCTGv4.0 (en lugar del WSCTGv1yv3) todo el código anterior seguirá funcionando.

Pero en lo referente a todo la operatoria de CTG actual se mantiene en el WSCTGv4.0 teniendo en cuenta estos cambios:

(válidos a partir del instalador 43.60 de la interfaz o superior)

Si ya esta usando la versión WSCTGv3 (g1version=1) el cambio principal es cargar g1version a valor 4 (para conectar el WSCTGv4) y usar la propiedad g1turno para informar el dato de turno o cupo al solicitar o confirmar CTG.

Y se agaregan los métodos:

g4desviarCTGAOtroDestino

g4desviarCTGAOtroEstablecimiento

g4cambiarDestinoDestinatarioCTGRechazado

que incluyen un parámetro extra para pasar el dato de turno (los métodos anteriores siguen funcionando pero al no incluir un parámetro para el dato de turno lo informarán como vació)

Detalle de actualización:

g1Version: Esta propiedad debe ser puesta a 4 (por defecto esta a 0) para que la interfaz conecte al WSCTG4. Es decir que estando esta propiedad a 4, cada vez que se ejecuta algún método del WSCTG como g1SolicitarCTGInicial, g1AnularCTG la interfaz automáticamente conectará al WSCTG4. De esta forma no habrá métodos y propiedades como g4SolicitarCTGInicial, g4AnularCTG, etc. (excepto el detallado más abajo) Ni necesidad de cambiar el código actual. Solo indicar con g1Version a que versión del web service nos conectamos.

g1Turno: (string o cadena) este campo permite informar el turno (o cupo) obtenido para se asignado al CTG. debe ser cargado junto con los demás datos antes de los métodos:

g1SolicitarCTGIniciar, g1SolicitarCTGDatoPendiente

g1CTGRespuestaTarifaReferencia: Los métodos g1SolicitarCTGInicial y g1ConsultarDetalleCTG a las propiedades de respuesta agregan el campo g1CTGRespuestaTarifaReferencia

g1desviarCTGAOtroDestino: Este método en el WSCTGv1 tiene 5 argumentos (CUIT, cartaporte, CTG, localidad, CUIT destino) y en el WSCTGv4 agrega un 6 y 7 argumento: Km. a recorrer u turno. Para mantener la compatiblidad este 6to y 7to dato es tomado como 0 y """ por el método y en caso que se lo quiera cargar se debe usar el método g4desviarCTGAOtroDestino que si acepta 7 argumentos (km. y turnos)

g1desviarCTGAOtroEstablecmiento: Idem anterior. Para pasar el argumento extra de km. a recorrer y turno se debe usar el método g4desviarCTGAOtroEstablecmiento que acepta dos argumentos extra.

g1SolicitarCTGinicial: (desde WSCTGv4, instalador 43.60 o superior) agregar como campo de entrada la propiedad tipo string:

g1Turno

g1CTGremitenteComercialComoCanjeador valores (S, N o blanco) o bien g1CTGremitenteComercialComoCanjeadorNo a verdadero para no enviar el dato

g1CTGremitenteComercialComoProductor valores (S, N o blanco) o bien g1CTGremitenteComercialComoProductorNo a verdadero para no enviar el dato

g1CTGcuitCorredor (y su asociada g1CTGCUITCorredorNo)

g1CTGcuitCanjeador (y su asociada g1CTGCUITCanjeadorNo)

El campo cuitRemitenteComercial aparentemente ya no está vigente y en su lugar se usa la combinación cuitCanjeador (con cuitCanjeadorNo a falso) y RemitenteComercialComoCanjeador a N (o S) para indicar el remitente comercial.

g1ConfirmarArribo: agregar como campo de entrada la propiedad tipo string: g1CTGConsumoPropio y g1CTGCUITChofer.

g1ConfirmarCTGDefinitivamente: Este método tiene 3 argumentos en el WSCTGv1 (CUIT, cartaporte, CTG). Para mantener la compatibilidad se implementa el método g2ConfirmarCTGDefinitivamente que acepta 3 argumentos extras: codigoCosecha, codigoEspecie y PesoNeto, este último puede quedar en blanco pero es obligatorio pasar los 6 argumentos. Ademas la respuesta de este método en el WSCTG4 solo comprende la propiedad g1RespuestaCTGObservacion, Los campos CTG y código de la operación ya no son devueltos por el servidor.

g2ConsultarCTGPendientesResolucion: Es un método del nuevo WSCTG4. Devolvería una lista de los CTG: pendientes, otorgados y confirmados.

g2RegresarAOrigenCTGRechazado: Es un método del nuevo WSCTG4. Equivalente al gRegresarAOrigenCTGRechazado pero aceptando un argumento extra (el 4to) para los Km.

La documentación de AFIP para el nuevo web services se encuentra adjunto al PIE

Un ejemplo similar al WSCTGv1 pero adaptado a los cambios del WSCTGv4.

Tambien se adaptó planilla de test en WSCTGv4Test (al pie)