Introducción

Este documento incluye información sobre la Clase WSCPE, los métodos públicos agrupados por funcionalidad y las propiedades de la Clase Respuesta.

Clase WSCPE

Esta clase proporciona una interfaz para interactuar con los servicios web de Carta Porte Electrónica (CPE) de ARCA para el transporte de granos en Argentina. 

Visión general

• es un componente expuesto como COM
• maneja la autenticación y comunicación con los servicios web CPE de ARCA. 
• permite crear, modificar, consultar y gestionar documentos electrónicos de 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.
• pathpdf(xpath): Establece la ruta donde se guardarán los archivos PDF generados.
• 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) Métodos de Ingreso de Datos CPE

• Addcartaporte(tipoCPE, cartaporte, sucursal): Establece los datos de identificación de la CPE.
• AddcabeceraAutomotor(cuitSolicitante, nroOrden, tipoCP, sucursal): Establece la información de cabecera para el transporte automotor.
• Addorigen(codLocalidad_Oper, codProvincia_Oper, planta, codLocalidad_Prod, codProvincia_Prod): Establece la información de origen de la carga.
• Addintervinientes(...): Establece la información sobre todas las partes involucradas en la transacción (titular, remitente comercial, etc.).
• AdddatosCarga(codGrano, cosecha, pesoBruto, pesoTara): Establece los detalles de la carga, como tipo de grano y pesos.
• AddDestino(xCuit, esDestinoCampo, codProvincia, codLocalidad, planta): Establece la información del destino de la carga.
• AddTransporte(...): Establece los detalles del transporte (transportista, chofer, etc.).
• AddModifTransporte(fechaHoraPartida, kmRecorrer, codigoTurno): Modifica la información del transporte para una CPE existente.
• AddDominio(xvalor): Agrega un dominio (patente) de vehículo a la lista.
• DeleteDominio(): Borra la lista de dominios de vehículos cargados.
• AddContingencia(concepto, descripcion): Agrega información de una contingencia.
• Adddestinatario(cuit): Establece el CUIT del destinatario.
• Addretiroproductor(cuitRemitenteComercialProductor): Establece la información para un retiro de productor.
• AddDesactivacionSolicitud(concepto, descripcion): Establece la información para una solicitud de desactivación.
• AddReactivacionDestinoFerroviariaSolicitud(cuitTransportista, nroOperativo): Establece la información para reactivar un destino ferroviario.
• AddConfintervinientes(cuitRepresentanteRecibidor): Establece la confirmación de los intervinientes.
• AddConfEditintervinientes(...): Establece la confirmación editada de los intervinientes.
• AddDesvioDestinoAutomotor(...): Establece la información para registrar un desvío de destino en transporte automotor.

C) Operaciones CPE

• AutorizarCPEAutomotor(correspondeRetiroProductor, esSolicitanteCampo): Solicita la autorización de una nueva CPE para transporte automotor.
• editarCPEAutomotor(...): Edita una CPE activa existente.
• editarCPEConfirmadaAutomotor(nroCTG): Edita una CPE que ya ha sido confirmada.
• anularCPE(): Cancela una CPE previamente autorizada.
• confirmarArriboCPE(xcuit): Confirma el arribo de una CPE a destino.
• rechazoCPE(xcuit): Rechaza una CPE en destino.
• descargadoDestinoCPE(xcuit): Marca una CPE como descargada en su destino.
• desvioCPEAutomotor(cuitSolicitante): Registra un desvío de ruta para una CPE automotor.
• confirmacionDefinitivaCPEAutomotor(cuitSolicitante, pesoBrutoDescarga, pesoTaraDescarga): Registra la confirmación definitiva de una CPE, incluyendo los pesos finales.
• regresoOrigenCPEAutomotor(): Registra el regreso al origen de una CPE automotor.
• nuevoDestinoDestinatarioCPEAutomotor(): Establece un nuevo destino o destinatario para una CPE.
• informarContingencia(): Reporta una contingencia para una CPE.
• cerrarContingenciaCPE(xconcepto): Cierra una contingencia previamente reportada.

D) Consultas e Información

• consultarCPEAutomotor(cuitsolicitante, nroCTG): Consulta los datos de una CPE automotor específica por su número de CTG.

• consultarCPEPorDestino(xfechaPartidaDesde, xfechaPartidaHasta, xplanta, xtipoCartaPorte): Consulta CPEs por un rango de fechas de partida y otros filtros.

• consultarCPEPorDestino1(...): Versión extendida de consultarCPEPorDestino que retorna detalles adicionales.

• consultarCPEPPendientesDeResolucion(xplanta, xSolicitanteDestino): Consulta las CPEs que están pendientes de resolución en una planta.

• consultarLocalidadesPorProvincia(codprov): Obtiene el listado de localidades para un código de provincia.

• ConsultarPlantas(cuit): Obtiene las plantas asociadas a un CUIT.

• ConsultarProvinicias(): Obtiene el listado completo de provincias.

• consultarTiposGrano(): Obtiene el listado de tipos de grano.

• ConsultarUltimoNroOrden(sucursal, tipoCPE): Obtiene el último número de orden utilizado para un tipo de CPE y sucursal.

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

D) Métodos de Utilidad

• GuardaArchBIN(xrespuesta): Guarda en un archivo el PDF contenido en una respuesta del servicio.

Clase Respuesta

La clase Respuesta encapsula todos los datos devueltos por los servicios de ARCA tras una operación. Incluye las siguientes propiedades:

• Estado de la operación: Proceso

• Información de error: HayErrores, errores.

• Datos del documento: cartaPorte, ctg, fechaHora

• Contenido de la respuesta: Resultado

• Documento PDF: pdf, pathpdf

• Datos XML: XMLAutorizacion, XMLEnvio, XMLRespuesta