Especificación de Requisitos

 

Proyecto/Versión: MI002/PROTHEUS 11.8

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

Alteración

Actualizaciones->Origen->Movimientos Internos->Recepcion de Grano

OGA250A-Rutina con llamadas a los WS

 

 

WEBSERVAGRO- Web services para la AFIP

 

 





Estrategia de Desarrollo y Liberación

 

Producto

SIGAAGR

Release que está siendo desarrollado

11.8

Tiene réplica?

(X)Si ( )No

Qué versión?

12.1.13


Objetivo



Ajustar opción Recepción de Grano (oga250) para que permita Confirmación de arribo, Rechazo de arribo, Desvío de destino o Regreso a origen del Código de Trazabilidad de Granos (CTG).
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, solicitara 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 valido.

Submenú de opciones de envío de avisos de trazabilidad del grano.
Se creara una sub opción en el menú de Acciones Relacionadas, titulada "Confirmación de CTG", la cual al ser seleccionada visualizara las sub opciones (ver prototipo 02):
Confirmar de Arribo
Confirmación Definitiva
Desviar CTG a Otro Establecimiento
Desviar CTG a Otro Destino
Rechazar CTG
Cambiar destino y destinatario a CTG rechazada
Regresar Origen CTG Rechazado
Imprimir CTG confirmado


Se creara 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, visualizara los diferentes valores que este puede tener (ver prototipo 04).

Sub opción Confirmar Arribo
Al ingresar a esta opción, primero validara que el registro seleccionado tenga status valido (NJJ_STACTP =''), de lo contrario enviara al usuario el mensaje "Para Confirmar Arribo la recepción de grano, debe estar con status de solo registro".
Si el status es valido, realizara 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 erronea, enviara al usuario el mensaje del error que dio como resultado la consulta (prototipo 10) e interrumpira el proceso.
Si la respuesta de la consulta fue exitosa, visualizara la pantalla como sigue(ver prototipo 05):
Carta de Porte .- Solo se visualizara y es obligatorio . Numero de Carta de Porte del registro seleccionado (njj_carta).
C.T.G. .- Solo se visualizara y es obligatorio . Código de Trazabilidad de Grano del registro seleccionado (njj_codctg).
Establecimiento destino .- Solo se visualizara. Se obtiene del resultado del método ConsultarDetalleCTG del elemento Establecimiento.
CUIT Transportista : Obligatorio, solo se visualizara. Se obtiene del resultado del método ConsultarDetalleCTG del elemento cuitTransportista.
Kg. Netos consignados en el Carta Porte : Obligatorio, solo se visualizara. Se obtiene del resultado del método ConsultarDetalleCTG del elemento PesoNetoCarga
¿Consumo Propio? .- Podrá seleccionar entre Si / No, por default visualizara No.


Al seleccionar Confirmar, primero validara que todos los datos que son obligatorios de acuerdo a la de solicitud, contengan información, de lo contrario cancelara 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

Parametro de entrada.

cantKilosCartaPorte

Parametro de entrada.

Establecimiento

Parametro de entrada.

consumoPropio

Parametro 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). Actualizara el status de la lista de empaque para Confirmación Arribo (NJJ_STACTP:='1') y el codigo de operación que retorno el WS (NJJ_COEARR=codigoOperacion).
Para la impresión del CTG ingresara a la opción Imprimir CTG confirmado, que se explica al final de este documento.



Si la respuesta es errónea, notificara 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 validara que el registro seleccionado tenga status Confirmacion de Arribo (NJJ_STACTP='1'), de lo contrario enviara al usuario el mensaje "Para Confirmación Definitiva , el CTG debe tener status de Confirmación de Arribo".
Si el status es valido, realizara 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 Confirmacion Arribo).
Al ingresar a esta opción visualizara y solicitara algunos datos como sigue (ver prototipo 08):
Carta de Porte .- Solo se visualizara y es obligatorio . Numero de Carta de Porte del registro seleccionado (njj_carta).
C.T.G. .- Solo se visualizara y es obligatorio . Código de Trazabilidad de Grano del registro seleccionado (njj_codctg).
Especie : Solo se visualizara. Se obtiene del resultado del método ConsultarDetalleCTG del elemento Especie.
Cosecha : .- Solo se visualizara Se obtiene del resultado del método ConsultarDetalleCTG del elemento Cosecha
Peso Neto .- Obligatorio, valor en kilos.

Al seleccionar Confirmar, primero validara 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

Parametro de entrada

Código Cosecha

Parametro de entrada

PesoNeto

Parametro de entrada



Respuesta de la consulta:








Si la respuesta de la consulta es exitosa enviara al usuario el mensaje con los datos de la misma (ver prototipo 09).

Y actualizara el status de la lista de empaque 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 enviara 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, validara que el status Confirmacion de Arribo (NJJ_STACTP='1'), de lo contrario enviara 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 valido visualizara y solicitara algunos datos como sigue (ver prototipo 11):
Carta de Porte .- Solo se visualizara y es obligatorio . Numero de Carta de Porte del registro seleccionado (njj_carta).
C.T.G. .- Solo se visualizara 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 validara 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 DesviarCTGAotroDestino.
Método DesviarCTGAotroDestino:
Solicitud de consulta:



Equivalencia de campos con PROTHEUS:

Campo

Protheus

cartaPorte

NJJ_CARTA

CTG

NJJ_CODCTG

Kms. a Recorrer

Parametro de entrada.

Localidad de Pago

Parametro de entrada.

CUITDestino

Parametro de entrada.



Respuesta de la consulta:





Si la respuesta de la consulta es exitosa enviara al usuario el mensaje con los datos de la misma (ver prototipo 12).

Y actualizara el status de la lista de empaque 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 enviara al usuario el mensaje de error reportado por la consulta.




Sub opción Desviar CTG a otro Establecimiento
Al ingresar a esta opción, validara que el status Confirmacion de Arribo (NJJ_STACTP='1'), de lo contrario enviara 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 valido visualizara y solicitara algunos datos como sigue (ver prototipo 13):
Carta de Porte .- Solo se visualizara y es obligatorio . Numero de Carta de Porte del registro seleccionado (njj_carta).
C.T.G. .- Solo se visualizara 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 validara 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

Parametro de entrada.

Kms. a Recorrer

Parametro de entrada.

Localidad de Pago

Parametro de entrada.



Respuesta de la consulta:




Si la respuesta de la consulta es exitosa enviara al usuario el mensaje con los datos de la misma (ver prototipo 14).

Y actualizara el status de la lista de empaque 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 enviara al usuario el mensaje de error reportado (ver prototipo 10).

Sub opción Rechazar CTG
Al ingresar a esta opción, primero validara que el registro seleccionado tenga status valido (NJJ_STACTP='1'), de lo contrario enviara al usuario el mensaje "Para Rechazar CTG, desbe estar en status de Confirmado". Si el status es valido, visualizara y solicitara algunos datos como sigue (ver prototipo 15):
Carta de Porte .- Solo se visualizara y es obligatorio . Numero de Carta de Porte del registro seleccionado (njj_carta).
C.T.G. .- Solo se visualizara 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 validara 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

Parametro de entrada.


Respuesta de la consulta:



Si la respuesta de la consulta es exitosa enviara al usuario el mensaje con los datos de la misma (ver prototipo 16).
Y actualizara el status de la lista de empaque a Rechazada (NJJ_STACTP:='5') y el codigo de operación que retorno el WS (NJJ_COEREC=codigoOperacion).


Si la respuesta es errónea enviara 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 validara que el registro seleccionado tenga status de rechazo (NJJ_STACTP='5'), de lo contrario enviara al usuario el mensaje "Esta opción solo aplica si el CTG estacon status de rechazado". Si el status es valido, visualizara y solicitara algunos datos como sigue (ver prototipo 17):
Carta de Porte .- Solo se visualizara y es obligatorio . Numero de Carta de Porte del registro seleccionado (njj_carta).
C.T.G. .- Solo se visualizara y es obligatorio . Código de Trazabilidad de Grano del registro seleccionado (njj_codctg).
Provincia de Destino : Obligatorio. Código de la Provincia destino de acuerdo a la AFIP. Podra seleccionar de la tabla 12.
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 validara 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

Provincia de Destino

Parametro de entrada

Localidad de Destino

Parametro de entrada

CUIT Destino

Parametro de entrada

CUIT Destinatario

Parametro de entrada

Km a recorrer

Parametro de entrada



Respuesta de la consulta:



Si la respuesta de la consulta es exitosa enviara al usuario el mensaje con los datos de la misma (ver prototipo 18).
Y actualizara el status de la lista de empaque a Desvio de destino y destinatario (NJJ_STACTP:='6') y el codigo de operación que retorno el WS (NJJ_COECDD=codigoOperacion).


Si la respuesta es errónea enviara 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 validara que el registro seleccionado tenga status de rechazo (NJJ_STACTP='5'), de lo contrario enviara al usuario el mensaje "Esta opción solo aplica si el CTG esta rechazado". Si el status es valido, visualizara y solicitara algunos datos como sigue (ver prototipo 19):
Carta de Porte .- Solo se visualizara y es obligatorio . Numero de Carta de Porte del registro seleccionado (njj_carta).
C.T.G. .- Solo se visualizara y es obligatorio . Código de Trazabilidad de Grano del registro seleccionado (njj_codctg).
Provincia de Origen : Obligatorio. Código de la Localidad origen de acuerdo a la AFIP. Podra seleccionar de la tabla 12.
Localidad de Origen : Obligatorio. Código de la Localidad origen de acuerdo a la AFIP. Podra seleccionar de la tabla S1.
Kms. a recorrer.- Obligatorio.

Al seleccionar Confirmar, primero validara 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

Provincia de Origen

Parametro de entrada

Localidad de Origen

Parametro de entrada

Km a recorrer

Parametro de entrada



Respuesta de la consulta:



Si la respuesta de la consulta es exitosa enviara al usuario el mensaje con los datos de la misma (ver prototipo 18).
Y actualizara el status de la lista de empaque Regreso a Origen (NJJ_STACTP:='7') y el codigo de operación que retorno el WS (NJJ_COEREG=codigoOperacion).

Si la respuesta es errónea enviara 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 validara que el registro seleccionado tenga status Confirmacion de Arribo (NJJ_STACTP='1'), de lo contrario enviara 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 valido, realizara 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 enviara 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 enviara al usuario el mensaje de error reportado por la consulta .
Tablas Utilizadas


Prototipo de Pantalla


Prototipo 01
[Regresar

#R01]



Prototipo 02
[Regresar

#r02]




Prototipo 03
[Regresar

#r03]


Prototipo 04
[Regresar

#r04]


Prototipo 05
[Regresar

#r05]



Prototipo 06
[Regresar

#r06]


Prototipo 07
[Regresar

#r07]

Prototipo 08
[Regresar

#r08]

Prototipo 09
[Regresar

#r09]

Prototipo 10
[Regresar

#r10]

Prototipo 11
[Regresar

#r11]

Prototipo 12
[Regresar

#r12]

Prototipo 13
[Regresar

#r13]


Prototipo 14
[Regresar

#r14]

Prototipo 15
[Regresar

#r15]

Prototipo 16
[Regresar

#r16]

Prototipo 17
[Regresar

#r17]

Prototipo 18
Regresar


Prototipo 19
[Regresar

#r19]








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 Confirmacion de arribo

Picture

@!

Contexto

Real

Propiedad

Visualizar

Usado

No

Browse

Si

Help de Campo

Codigo de Operación Electrónico de Confirmacion de Arribo





Campo

NJJ_COEDEF

Tipo

C

Tamaño

8

Título

COE Conf Def.

Descripción

COE Confirmacion definitiva

Picture

@!

Contexto

Real

Propiedad

Visualizar

Usado

No

Browse

Si

Help de Campo

Codigo de Operación Electrónico de Confirmacion 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


  1. Caso(s) de Pruebas Específico(s) del Proyecto



Caso de Pruebas

<Indique el nombre del caso de pruebas>

 

 

Finalida de la Pruebas

<Defina cuál será la finalidade de este caso de prueba >

Estimativas

<Indicar el valor total para la ejecución de este caso de prueba, considerando el tiempo de las pre- condiciones y las post- condiciones que se describen a continuación>

Prueba del Programador

( ) Si ( ) No

Recomendaciones

<Indique las particularidades que deben ser consideradas em este caso de pruebas. Ejemplo: Ejecutar esse caso de pruebas dos veces, uma com la versión actual de la rutina y la outra com la versión del desarrollo para garantizar que no ocurrirán diferencias más allá de las solicitadas por este desarrollo>

Pré-condiciones

<Enumere los requisitos que deben ser consideradas cuando se ejecute este caso de prueba>

Póst-condiciones

<Enumere los resultados de los casos de prueba que deben ser considerados después de la ejecución de las mismas>

Cómo verificar los resultados

<Detalle como deberán ser verificados lso resultados de las pruebas>

Procedimientos

Resultados Esperados

<Enumere los pasos que deben ser ejecutados para la realización de las pruebas >

<Enliste los resultados esperados>