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ónModificacion | Actualizaciones->Origen->Movimientos Internos->Recepcion 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 | 1112.1.87 |
Tiene réplica? | ( X )Si (X)No |
Qué versión?12.1.13 | |
Âncora |
---|
| _Toc380063576 |
---|
| _Toc380063576 |
---|
|
Objetivo
...
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
- NJJ – Embalajes
- SA4 – Transportista
- NL0 – Carta de Porte
- SX5 – Tabla 12 y S1
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_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 |
- 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> |