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).

Definición de las Reglas de Negocio


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 de Pantalla



Prototipo 01

Regresar




Prototipo 02
Regresar

 




Prototipo 03

Regresar




Prototipo 04

Regresar 




Prototipo 05

Regresar 





Prototipo 06
Regresar 

 



Prototipo 07

Regresar 



Prototipo 08
Regresar 

Prototipo 09

Regresar 



Prototipo 10
Regresar 




Prototipo 11

Regresar 




Prototipo 12

Regresar 



Prototipo 13

Regresar 

Prototipo 14

Regresar 



Prototipo 15

Regresar 


Prototipo 16

Regresar 



Prototipo 17

Regresar 

 



Prototipo 18
Regresar 


Prototipo 19
Regresar 

 

 

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
granos y ganados en el país

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