Especificación de Requisitos | |
Proyecto/Versión: MI002/PROTHEUS 12.1.15 | Requisito/Módulo: PCREQ-10710/SIGAAGR |
Sub-Requisito/Función: Recepción de Grano | Tarea/Llamado: PDR_SER_MI002-75 |
País: Argentina | Fecha de especificación: 05/04/16 |
Rutinas Involucradas | ||
Rutina | Tipo de Operación | Opción de Menú |
OGA250-Recepción de Grano | Modificacion | Actualizaciones->Origen->Movimientos Internos->Recepción de Grano |
OGA250A-Rutina con llamadas a los WS | Incluir |
|
WEBSERVAGRO- Web services para la AFIP | Incluir |
|
Estrategia de Desarrollo y Liberación | |
Producto | SIGAAGR |
Release que está siendo desarrollado | 12.1.7 |
Tiene réplica? | ( )Si (X)No |
Qué versión? |
|
Objetivo
Ajustar opción Recepción de Grano (OGA250) para que permita conexión con la AFIP y realice la Confirmar de Arribo, Confirmación definitiva, Desviar CTG a otro destino, Desviar CTG a otro establecimiento, Rechazar CTG, Cambiar destino y destinatario a CTG Rechazado, Regresar a origen CTG rechazado, Imprimir CTG confirmado.
Definición:
El Código de Trazabilidad de Granos , es un mecanismo que permite asegurar la trazabilidad de los productos agroalimentarios durante el traslado que se realiza entre los distintos operadores del sector.
El Código de Trazabilidad de Granos, deberá ser consignado en cada carta de porte que ampare el traslado de los granos por vía terrestre (excepto transporte ferroviario) y se obtendrá en forma previa al traslado de la mercadería (deberá encontrarse vinculado a una carta de porte vigente).
Nuevos Campos.
En el encabezado del registro de datos, solicitará el número de Carta porte y el CTG (vea prototipo 01):
Carta Porte.- (campo NJJ_CARTA, Obligatorio editable) Número de carta porte, podrá seleccionar del archivo de carta portes (NL0). Y validará que el carta porte exista en dicho archivo. Al salir de este campo llenará el valor del campo del CTG (NJJ_CODCTG=NL0_CODCTG).
CTG .- (campo NJJ_CODCTG, solo visualizar) Código de Trazabilidad de Granos, será informado al seleccionar un carta porte válido.
Submenú de opciones de envío de avisos de trazabilidad del grano.
Se creará una sub opción en el menú de Acciones Relacionadas, titulada "Confirmación de CTG", la cual al ser seleccionada visualizará las sub opciones (ver prototipo 02):
Confirmar Arribo
Confirmación Definitiva
Desviar CTG a Otro Destino
Desviar CTG a Otro Establecimiento
Rechazar CTG
Cambiar destino y destinatario a CTG rechazada
Regresar a Origen CTG Rechazado
Imprimir CTG Confirmada
Se creará un campo (campo NJJ_STACTP) para el control del status del CTG, el cual será visualizado en el browse (ver prototipo 03).
Al dar doble clic en el browse, sobre ese campo, visualizará los diferentes valores que este puede tener (ver prototipo 04).
Sub opción Confirmar Arribo
Al ingresar a esta opción, primero validará que el registro seleccionado tenga status válido (NJJ_STACTP =''), de lo contrario enviará al usuario el mensaje "Para Confirmar Arribo la recepción de grano, debe estar con status de solo registro".
Si el status es válido, realizará una consulta de los detalles del CTG seleccionado, haciendo uso del WS CTGService_v2.0 y utilizando el método consultarDetalleCTG.
Método consultarDetalleCTG:
Solicitud de consulta:
Respuesta de la consulta :
Si la respuesta de la consulta fue errónea, enviará al usuario el mensaje del error que dio como resultado la consulta ( prototipo 10) e interrumpirá el proceso.
Si la respuesta de la consulta fue exitosa, visualizará la pantalla como sigue(ver prototipo 05):
Carta de Porte .- Solo se visualizará y es obligatorio . Número de Carta de Porte del registro seleccionado (njj_carta).
C.T.G. .- Solo se visualizará y es obligatorio . Código de Trazabilidad de Grano del registro seleccionado (njj_codctg).
Establecimiento destino .- Editable . Se obtiene del resultado del método ConsultarDetalleCTG del elemento Establecimiento.
CUIT Transportista : Obligatorio, solo se visualizará. Se obtiene del resultado del método ConsultarDetalleCTG del elemento cuitTransportista.
Kg. Netos consignados en el Carta Porte : Obligatorio, solo se visualizará. Se obtiene del resultado del método ConsultarDetalleCTG del elemento PesoNetoCarga
¿Consumo Propio? .- Podrá seleccionar entre Si / No, por default visualizará No.
Al seleccionar Confirmar, primero validará que todos los datos que son obligatorios de acuerdo a la solicitud, contengan información, de lo contrario cancelará el proceso, enviando al usuario un aviso del error ocurrido.
Si la consulta fue exitosa, procederá a utilizar el método DatosConfirmarArribo.
Método DatosConfirmarArribo:
Solicitud de consulta:
Equivalencia de campos con PROTHEUS:
Campo | Protheus |
cartaPorte | NJJ_CARTA |
CTG | NJJ_CODCTG |
cuitTransportista | Parámetro de entrada. |
cantKilosCartaPorte | Parámetro de entrada. |
Establecimiento | Parámetro de entrada. |
consumoPropio | Parámetro de entrada. |
cuitChofer | Buscar en la tabla NL0 donde NL0_CODCTG=NJJ_CODCTG y NL0_CARTA=NJJ_CARTA y obtener el cuit del chofer contenido en el campo NL0_CUITCHO |
Respuesta de la consulta:
Si la respuesta de la consulta es exitosa notificará al usuario, enviado una pantalla con los datos de fecha y hora de la notificación (ver prototipo 06). Actualizará el estatus de la lista de embarque para Confirmación Arribo (NJJ_STACTP:='1') y el código de operación que retorno el WS (NJJ_COEARR=codigoOperacion).
Para la impresión del CTG ingresará a la opción Imprimir CTG confirmado, que se explica al final de este documento.
Si la respuesta es errónea, notificará al usuario enviando una pantalla con la descripción del error (ver ejemplo en prototipo 07).
Sub opción Confirmación Definitiva
Al ingresar a esta opción, primero validará que el registro seleccionado tenga status confirmación de Arribo (NJJ_STACTP='1'), de lo contrario enviará al usuario el mensaje "Para Confirmación Definitiva , el CTG debe tener status de Confirmación de Arribo".
Si el status es válido, realizará una consulta de los detalles del CTG seleccionado, haciendo uso del WS CTGService_v2.0 y utilizando el método consultarDetalleCTG (observe el uso de este método en la sección de la sub opcion confirmación Arribo).
Al ingresar a esta opción visualizará y solicitará algunos datos como sigue (ver prototipo 08):
Carta de Porte .- Solo se visualizará y es obligatorio . Número de Carta de Porte del registro seleccionado (njj_carta).
C.T.G. .- Solo se visualizará y es obligatorio . Código de Trazabilidad de Grano del registro seleccionado (njj_codctg).
Especie : Solo se visualizará. Se obtiene del resultado del método ConsultarDetalleCTG del elemento Especie.
Cosecha : .- Solo se visualizará Se obtiene del resultado del método ConsultarDetalleCTG del elemento Cosecha
Peso Neto .- Editable, valor en kilos.
Al seleccionar Confirmar, primero validará que todos los datos que son obligatorios, tengan información. Si pasa la validación hace uso del WS CTGService_v2.0 y procederá a utilizar el método ConfirmarDefinitivo.
Método ConfirmarDefinitivo:
Solicitud de consulta:
Equivalencia de campos con PROTHEUS:
Campo | Protheus |
cartaPorte | NJJ_CARTA |
CTG | NJJ_CODCTG |
Especie | Parámetro de entrada |
Código Cosecha | Parámetro de entrada |
PesoNeto | Parámetro de entrada |
Respuesta de la consulta:
Si la respuesta de la consulta es exitosa enviará al usuario el mensaje con los datos de la misma (ver prototipo 09).
Y actualizará el status de la lista de embarque a Confirmación definitiva (NJJ_STACTP:='2') y el codigo de operación que retorno el WS (NJJ_COEDEF=codigoOperacion).
Si la respuesta es errónea enviará al usuario el mensaje de error reportado por la consulta (ver prototipo 10).
Sub opción Desviar CTG a otro Destino
Al ingresar a esta opción, validará que el estatus Confirmación de Arribo (NJJ_STACTP='1'), de lo contrario enviará al usuario el mensaje "Para Desviar CTG a otro destino, debe tener estatus de Confirmación Arribo", e interrumpirá el proceso. Si el estatus es válido visualizará y solicitará algunos datos como sigue (ver prototipo 11):
Carta de Porte .- Solo se visualizará y es obligatorio . Número de Carta de Porte del registro seleccionado (NJJ_CARTA).
C.T.G. .- Solo se visualizará y es obligatorio . Código de Trazabilidad de Grano del registro seleccionado (NJJ_CODCTG).
Kms. a recorrer.- Obligatorio.
Localidad de Destino : Obligatorio. Código de la Localidad destino de acuerdo a la AFIP. Podra seleccionar de la tabla S1.
CUIT Destino : Obligatorio. CUIT destino de acuerdo.
Al seleccionar Confirmar, primero validará que todos los datos que son obligatorios y tengan información. Si pasa la validación hará uso del WS CTGService_v2.0 utilizando el método DesviarCTGAotroDestino.
Método DesviarCTGAotroDestino:
Solicitud de consulta:
Equivalencia de campos con PROTHEUS:
Campo | Protheus |
cartaPorte | NJJ_CARTA |
CTG | NJJ_CODCTG |
Kms. a Recorrer | Parámetro de entrada. |
Localidad Destino | Parámetro de entrada. |
CUITDestino | Parámetro de entrada. |
Respuesta de la consulta:
Si la respuesta de la consulta es exitosa enviará al usuario el mensaje con los datos de la misma (ver prototipo 12).
Y actualizará el status de la lista de embarque a Desvio a otro destino (NJJ_STACTP:='3') y el codigo de operación que retorno el WS (NJJ_COEDOD=codigoOperacion).
Si la respuesta es errónea enviará al usuario el mensaje de error reportado por la consulta.
Sub opción Desviar CTG a otro Establecimiento
Al ingresar a esta opción, validará que el status confirmación de Arribo (NJJ_STACTP='1'), de lo contrario enviará al usuario el mensaje "Para Desviar CTG a otro destino debe tener status de Confirmación Arribo", e interrumpirá el proceso. Si el status es válido visualizará y solicitará algunos datos como sigue (ver prototipo 13:
Carta de Porte .- Solo se visualizará y es obligatorio . Número de Carta de Porte del registro seleccionado (NJJ_CARTA).
C.T.G. .- Solo se visualizará y es obligatorio . Código de Trazabilidad de Grano del registro seleccionado (NJJ_CODCTG).
Kms. a recorrer.- Obligatorio.
Localidad de Destino : Obligatorio. Código de la Localidad destino de acuerdo a la AFIP. Podra seleccionar de la tabla S1.
Establecimiento : Obligatorio. Número de establecimiento destino de acuerdo a la AFIP.
Al seleccionar Confirmar, primero validará que todos los datos que son obligatorios, tengan información. Si pasa la validación hará uso del WS CTGService_v2.0 utilizando el método DesviarCTGAotroEstablecimiento.
Método DesviarCTGAotroEstablecimiento:
Solicitud de consulta:
Equivalencia de campos con PROTHEUS:
Campo | Protheus |
cartaPorte | NJJ_CARTA |
CTG | NJJ_CODCTG |
Establecimiento | Parámetro de entrada. |
Kms. a Recorrer | Parámetro de entrada. |
Localidad Destino | Parámetro de entrada. |
Respuesta de la consulta:
Si la respuesta de la consulta es exitosa enviará al usuario el mensaje con los datos de la misma (ver prototipo 14).
Y actualizará el status de la lista de embarque a Desvio a otro estblecimiento (NJJ_STACTP:='4) y el codigo de operación que retorno el WS (NJJ_COEDES=codigoOperacion).
Si la respuesta es errónea enviará al usuario el mensaje de error reportado (ver prototipo 10).
Sub opción Rechazar CTG
Al ingresar a esta opción, primero validará que el registro seleccionado tenga status válido (NJJ_STACTP='1'), de lo contrario enviará al usuario el mensaje "Para Rechazar CTG, desbe estar en status de Confirmado". Si el status es válido, visualizará y solicitará algunos datos como sigue (ver prototipo 15):
Carta de Porte .- Solo se visualizará y es obligatorio . Número de Carta de Porte del registro seleccionado (NJJ_CARTA).
C.T.G. .- Solo se visualizará y es obligatorio . Código de Trazabilidad de Grano del registro seleccionado (NJJ_CODCTG).
Motivo : Texto obligatorio informando las causas del rechazo.
Al seleccionar Confirmar, primero validará que todos los datos que son obligatorios, tengan información. Si pasa la validación hará uso del WS CTGService_v2.0 utilizando el método RechazarCTG.
Método RechazarCTG:
Solicitud de consulta:
Equivalencia de campos con PROTHEUS:
Campo | Protheus |
cartaPorte | NJJ_CARTA |
CTG | NJJ_CODCTG |
Motivo | Parámetro de entrada. |
Respuesta de la consulta:
Si la respuesta de la consulta es exitosa enviará al usuario el mensaje con los datos de la misma (ver prototipo 16).
Y actualizará el status de la lista de embarque a Rechazada (NJJ_STACTP:='5') y el codigo de operación que retorno el WS (NJJ_COEREC=codigoOperacion).
Si la respuesta es errónea enviará al usuario el mensaje de error reportado (ver prototipo 10).
Sub opción Cambiar destino y destinatario a CTG rechazado
Al ingresar a esta opción, primero validará que el registro seleccionado tenga status de rechazo (NJJ_STACTP='5'), de lo contrario enviará al usuario el mensaje "Esta opción solo aplica si el CTG esta con estatus de rechazado". Si el estatus es válido, visualizará y solicitará algunos datos como sigue (ver prototipo 17):
Carta de Porte .- Solo se visualizará y es obligatorio . Número de Carta de Porte del registro seleccionado (NJJ_CARTA).
C.T.G. .- Solo se visualizará y es obligatorio . Código de Trazabilidad de Grano del registro seleccionado (NJJ_CODCTG).
Localidad de Destino : Obligatorio. Código de la Localidad destino de acuerdo a la AFIP. Podra seleccionar de la tabla S1.
CUIT Destino .- Obligatorio. CUIT del nuevo destino.
CUIT Destinatario .- Obligatorio. CUIT del nuevo destino.
Kms. a recorrer.- Obligatorio.
Al seleccionar Confirmar, primero validará que todos los datos que son obligatorios, tengan información. Si pasa la validación hará uso del WS CTGService_v2.0 utilizando el método CambiarDestinoDestinatarioCTGrechazado.
Método CambiarDestinoDestinatarioCTGrechazado:
Solicitud de consulta:
Equivalencia de campos con PROTHEUS:
Campo | Protheus |
cartaPorte | NJJ_CARTA |
CTG | NJJ_CODCTG |
Localidad de Destino | Parámetro de entrada |
CUIT Destino | Parámetro de entrada |
CUIT Destinatario | Parámetro de entrada |
Km a recorrer | Parámetro de entrada |
Respuesta de la consulta:
Si la respuesta de la consulta es exitosa enviará al usuario el mensaje con los datos de la misma (ver prototipo 18).
Y actualizará el status de la lista de embarque a Desvio de destino y destinatario (NJJ_STACTP:='6') y el código de operación que retorno el WS (NJJ_COECDD=codigoOperacion).
Si la respuesta es errónea enviará al usuario el mensaje de error reportado por la consulta (ver prototipo 10)., por ejemplo:
Sub opción Regresar Origen CTG Rechazado
Al ingresar a esta opción, primero validará que el registro seleccionado tenga status de rechazo (NJJ_STACTP='5'), de lo contrario enviará al usuario el mensaje "Esta opción solo aplica si el CTG esta rechazado". Si el status es válido, visualizará y solicitará algunos datos como sigue (ver prototipo 19):
Carta de Porte .- Solo se visualizará y es obligatorio . Número de Carta de Porte del registro seleccionado (NJJ_CARTA).
C.T.G. .- Solo se visualizará y es obligatorio . Código de Trazabilidad de Grano del registro seleccionado (NJJ_CODCTG).
Kms. a recorrer.- Obligatorio.
Al seleccionar Confirmar, primero validará que todos los datos que son obligatorio, tengan información. Si pasa la validación hará uso del WS CTGService_v2.0 utilizando el método RegresaraOrigenCTGRechazado.
Método RegresaraOrigenCTGRechazado:
Solicitud de consulta:
Equivalencia de campos con PROTHEUS:
Campo | Protheus |
cartaPorte | NJJ_CARTA |
CTG | NJJ_CODCTG |
Km a recorrer | Parámetro de entrada |
Respuesta de la consulta:
Si la respuesta de la consulta es exitosa enviará al usuario el mensaje con los datos de la misma (ver prototipo 18).
Y actualizará el status de la lista de embarque Regreso a Origen (NJJ_STACTP:='7') y el código de operación que retorno el WS (NJJ_COEREG=codigoOperacion).
Si la respuesta es errónea enviará al usuario el mensaje de error reportado por la consulta (ver prototipo 10).
Sub opción Imprimir CTG Confirmado
Al ingresar a esta opción, primero validará que el registro seleccionado tenga status confirmación de Arribo (NJJ_STACTP='1'), de lo contrario enviará al usuario el mensaje "Es necesario que el satus del CTG a imprimir esté como Confirmación de Arribo", y detendrá el proceso.
Si el status es válido, realizará una consulta de los detalles del CTG seleccionado, haciendo uso del WS CTGService_v2.0 y utilizando el método consultarConstanciaCTGPDF.
Método consultarConstanciaCTGPDF:
Solicitud de consulta:
Donde en CTG debe llevar el contenido del campo NJJ_CODCET y cuitRepresentado debe se llevar el contenido del campo M0_CGC.
Respuesta de la consulta:
Si la respuesta de la consulta es exitosa enviará al usuario una pantalla visualizando los datos del PDF, y preguntando, como requiere enviar la impresión (si en pantalla,en impresora o envio por mail).
Si la respuesta es errónea enviará al usuario el mensaje de error reportado por la consulta .
Tablas Utilizadas
Prototipo 01
| |
| |
| |
| |
| |
| |
| |
Prototipo 09 | |
| |
| |
| |
| |
Prototipo 14 | |
| |
Prototipo 16 | |
| |
Release Notes
| |
Módulo | SIGAAGR |
Función | OGA250-Recepción de Grano |
Situación/Requisito | PCREQ-10710 |
Solución/Implementación | Certificacion de la recepción de grano ante la AFIP |
Diccionario de Datos
Agregar los campos a la tabla Archivo: NJJ– Recepcion de Grano
Campo | NJJ_CARTA |
Tipo | C |
Tamaño | 12 |
Descripción | Carta Porte |
Título | Carta Porte |
Picture | @! |
F3 | NL0 |
Validación | Si el campo no está vacío, verifique que exista M->NJJ_CARTA en la tabla NL0 y asigne a la variable M->NJJCODCTG:=NL0_CARTA |
Contexto | Real |
Propiedad | Alterar |
Browse | Si |
Obligatorio | Si |
Help de Campo | Es la documentación que acredita el legítimo movimiento de |
Campo | NJJ_CODCTG |
Tipo | C |
Tamaño | 8 |
Descripción | Cód. Traz. Grano |
Título | CTG |
Picture | @! |
Contexto | Real |
Propiedad | Visualizar |
Browse | Si |
Obligatorio | Si |
Help de Campo | Es un mecanismo que permite asegurar la trazabilidad de los productos agroalimentarios durante el traslado que se realiza entre los distintos operadores del sector. |
Campo | NJJ_STACTP |
Tipo | C |
Tamaño | 1 |
Descripción | St. C. Porte |
Título | Status de Carta de Porte |
Picture | @! |
Contexto | Real |
Propiedad | Visualizar |
Usado | No |
Browse | Si |
Opciones | ''=Registrada;1=Confirmada;2=Conf. Definitiva;3=Desvio Destino;4=Desvio Establ.; 5=Rechazada ;6= Destino y destinatário modificado;7=Retornada a Origen; |
Help de Campo | Status del carta porte |
Campo | NJJ_COEARR |
Tipo | C |
Tamaño | 8 |
Título | COE Conf Arrib |
Descripción | COE confirmación de arribo |
Picture | @! |
Contexto | Real |
Propiedad | Visualizar |
Usado | No |
Browse | Si |
Help de Campo | Codigo de Operación Electrónico de confirmación de Arribo |
Campo | NJJ_COEDEF |
Tipo | C |
Tamaño | 8 |
Título | COE Conf Def. |
Descripción | COE confirmación definitiva |
Picture | @! |
Contexto | Real |
Propiedad | Visualizar |
Usado | No |
Browse | Si |
Help de Campo | Codigo de Operación Electrónico de confirmación definitiva |
Campo | NJJ_COEDES |
Tipo | C |
Tamaño | 8 |
Descripción | COE Desvio otro Establecimiento |
Título | COE Desv Estab |
Picture | @! |
Contexto | Real |
Propiedad | Visualizar |
Usado | No |
Browse | Si |
Help de Campo | Codigo de Operación Electrónico de Desvio a Otro Establecimiento |
Campo | NJJ_COEDOD |
Tipo | C |
Tamaño | 8 |
Descripción | COE Desvio otro destin |
Título | COE Desv Dest. |
Picture | @! |
Contexto | Real |
Propiedad | Visualizar |
Usado | No |
Browse | Si |
Help de Campo | Codigo de Operación Electrónico de Desvio a Otro Destino |
Campo | NJJ_COEREC |
Tipo | C |
Tamaño | 8 |
Descripción | COE Rechazo de CTG |
Título | COE Rech CTG |
Picture | @! |
Contexto | Real |
Propiedad | Visualizar |
Usado | No |
Browse | Si |
Help de Campo | Codigo de Operación Electrónico por rechazo de CTG |
Campo | NJJ_COECDD |
Tipo | C |
Tamaño | 8 |
Descripción | COE Cambio dest y detinat a CTG rechazado |
Título | COE Cam Des y Desti |
Picture | @! |
Contexto | Real |
Propiedad | Visualizar |
Usado | No |
Browse | Si |
Help de Campo | Codigo de Operación Electrónico Cambio de Destino y Destinatario de CTG Rechazado |
Campo | NJJ_COEREG |
Tipo | C |
Tamaño | 8 |
Descripción | COE Regresar a Origen CTG rechazado |
Título | COE Regresar Origen |
Picture | @! |
Contexto | Real |
Propiedad | Visualizar |
Usado | No |
Browse | Si |
Help de Campo | Codigo de Operación Electrónico para Regresar a Origen CTG rechazado |