Introducción

Este documento incluye información sobre la Clase WSCTG para el transporte y trazabilidad de granos en Argentina, los métodos públicos agrupados por funcionalidad y las propiedades de la Clase Respuesta.

Clase WSCTG

Esta clase proporciona una interfaz para interactuar con los servicios web de Código de Trazabilidad de Granos (CTG) de ARCA para el transporte y la trazabilidad de granos en Argentina.

Visión general

• es un componente expuesto como COM
• maneja la autenticación y comunicación con los servicios web CTG de ARCA.
• permite crear, modificar, consultar y gestionar documentos electrónicos de CTG para el transporte de granos.

Métodos Públicos

A continuación se detallan los métodos públicos de la clase, agrupados por su funcionalidad.

A) Autenticación y Configuración

• Test(): Método simple para verificar si la clase está funcionando correctamente. Devuelve "Ok".

• Modo(valor): Establece el modo de operación para usar el entorno de desarrollo (1) o producción (2).

• StrRutaCertFirma(x): Establece la ruta al archivo del certificado digital (.p12).

• CertPW(x): Establece la contraseña para el certificado digital.

• Cuit(xcuit): Establece el CUIT a utilizar para las operaciones.

• SetToken(xToken): Establece el token de autenticación manualmente.

• SetSign(xSign): Establece la firma de autenticación manualmente.

• SetUniqueID(xUniqueid): Establece el ID único (UniqueID) manualmente.

• GetExpirationTime(): Devuelve la fecha y hora de vencimiento de la autenticación actual.

• GetGenerationTime(): Devuelve la fecha y hora de generación de la autenticación actual.

• IsLogin(): Verifica si la sesión actual (token y firma) sigue siendo válida.

• GetToken(): Devuelve el token de autenticación actual.

• GetSign(): Devuelve la firma de autenticación actual.

• GetUniqueID(): Devuelve el ID único (UniqueID) actual.

• Login(ClaveAutorizacion, token, sign): Realiza la autenticación con los servicios de ARCA para obtener un nuevo ticket de acceso. Devuelve el ID de la autenticación.

B) XML y Mensajes

• XMLliquidacion(): Devuelve el XML de la liquidación.
• XMLLogin(): Devuelve el XML del login.
• XMLRespuesta(): Devuelve el XML de la respuesta del servicio.
• Mensaje(): Devuelve los mensajes informativos del sistema.
• Errores(): Devuelve los errores ocurridos en la última operación.

C) Operaciones CTG

• anularCTG(cartaPorte, ctg): Cancela un CTG existente.

• cambiarDestinoDestinatarioCTGRechazado(...): Cambia el destino y destinatario de un CTG que fue rechazado.

• confirmarArribo(...): Confirma la llegada de un CTG a su destino.

• confirmarDefinitivo(...): Realiza la confirmación definitiva de un CTG.

• desviarCTGAOtroEstablecimiento(...): Cambia el destino de un CTG a otro establecimiento.

• desviarCTGAOtroDestino(...): Cambia el destino de un CTG a otra localidad o CUIT.

• RechazarCTG(cartaPorte, ctg, motivo): Rechaza un CTG recibido en destino.

• regresarAOrigenCTGRechazado(cartaPorte, ctg, kmARecorrer): Registra el regreso al origen de un CTG rechazado.

• modificarRemitenteComercial(...): Modifica el remitente comercial de un CTG.

D) Consultas

• consultarCTG(...): Consulta datos de CTG según diferentes criterios de búsqueda.

• consultarDetalleCTG(ctg): Consulta el detalle completo de un CTG específico.

• consultarCTGRechazados(): Consulta los CTG que han sido rechazados.

• CTGsRechazados(): Método alternativo que obtiene la lista de CTGs rechazados.

• consultarCTGActivosPorPatente(patente): Consulta los CTG activos asociados a una patente de vehículo.

• CTGsPendientesResolucion(): Consulta los CTG que están pendientes de resolución.

E) Consultas de Datos Maestros

• consultarCosechas(): Obtiene la lista de cosechas disponibles.
• consultarEspecies(): Obtiene la lista de especies de granos disponibles.
• consultarEstablecimientos(): Obtiene la lista de establecimientos asociados al CUIT autenticado.
• consultarLocalidadesPorProvinicia(): Obtiene las localidades disponibles por provincia.
• consultarProvinicias(): Obtiene la lista de provincias.
• BuscaCodigoEspecie(xDetalleEspecie): Busca el código de una especie a partir de su descripción.

F) Verificación

• MetodoFEDummy(): Verifica la conectividad y estado del servicio web de ARCA.

Clase Respuesta

La clase Respuesta encapsula todas las respuestas de los servicios de ARCA. Las propiedades se agrupan de la siguiente manera:

• Información de CTG: cartaPorte, ctg, fechaHora

• Detalles de la operación: codigoOperacion

• Fechas: fechaEmision, fechaVigencia

• Información de partes: cuitSolicitante, cuitDestino

• Información de transporte: patenteVehiculo, tarifaReferencia

• Datos de respuesta: Observacion

• Información de remitente comercial

• Listas de resultados: ArrayDatos, ArrayDatosCTGConsultar

• Detalles de CTG: DetalleCTG

• Errores: errores