Especificación de Requisitos | |
Proyecto/Versión: MI002/PROTHEUS 1112.1.815 | 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->Recepcion >Recepción de Grano |
OGA250A-Rutina con llamadas a los WS | Incluir | |
WEBSERVAGRO- Web services para la AFIP | Âncora |
---|
| _GoBack | _GoBack | 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 (oga250OGA250) para que permita conexión con la AFIP y realice la Confirmación Confirmar de arribo, Rechazo de arribo, Desvío de destino o Regreso a origen del Código de Trazabilidad de Granos (CTG)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, solicitara solicitará el número de Carta porte y el CTG (veavea
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 (
njjNJJ_
codctgCODCTG=NL0_
codctgCODCTG).
CTG .- (campo NJJ_CODCTG, solo visualizar) Código de Trazabilidad de Granos, será informado al seleccionar un carta porte
validoválido.
Submenú de opciones de envío de avisos de trazabilidad del grano. Se
creara creará una sub opción en el menú de Acciones Relacionadas, titulada "Confirmación de CTG", la cual al ser seleccionada
visualizara visualizará las sub opciones (ver
prototipo 02):
Confirmar de Arribo Arribo
Confirmación Definitiva
Desviar CTG a Otro EstablecimientoDestino
Desviar CTG a Otro DestinoEstablecimiento
Rechazar CTG
Cambiar destino y destinatario a CTG rechazada
Regresar a Origen CTG Rechazado
Imprimir CTG confirmado Confirmada
Se creara 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,
visualizara visualizará los diferentes valores que este puede tener (ver
prototipo 04).
Sub opción Confirmar Arribo
Al ingresar a esta opción, primero validara validará que el registro seleccionado tenga status valido válido (NJJ_STACTP =''), de lo contrario enviara enviará al usuario el mensaje "Para Confirmar Arribo la recepción de grano, debe estar con status de solo registro".
Si el status es validoválido, realizara realizará una consulta de los detalles del CTG seleccionado, haciendo uso del WS CTGService_v2.0 y utilizando el método consultarDetalleCTG.
Âncora |
---|
consultactg | consultactg | Método consultarDetalleCTGMétodo consultarDetalleCTG:
Solicitud de consulta:
Respuesta de la consulta :
Si la respuesta de la consulta fue erroneaerrónea, enviara enviará al usuario el mensaje del error que dio como resultado la consulta ( prototipo 10) e interrumpira interrumpirá el proceso.
Si la respuesta de la consulta fue exitosa, visualizara visualizará la pantalla como sigue(ver
prototipo 05):
Carta de Porte .- Solo se
visualizara visualizará y es obligatorio .
Numero Número de Carta de Porte del registro seleccionado (njj_carta).
C.T.G. .- Solo se
visualizara visualizará y es obligatorio . Código de Trazabilidad de Grano del registro seleccionado (njj_codctg).
Establecimiento destino .-
Solo se visualizaraEditable . Se obtiene del resultado del método
ConsultarDetalleCTG del elemento
Establecimiento.
CUIT Transportista : Obligatorio, solo se
visualizaravisualizará. Se obtiene del resultado del método
ConsultarDetalleCTG del elemento
cuitTransportista.
Kg. Netos consignados en el Carta Porte : Obligatorio, solo se
visualizaravisualizará. Se obtiene del resultado del método
ConsultarDetalleCTG del elemento
PesoNetoCarga ¿Consumo Propio? .- Podrá seleccionar entre Si / No, por default
visualizara visualizará No.
Al seleccionar Confirmar, primero
validara validará que todos los datos que son obligatorios de acuerdo
a la de solicituda la solicitud, contengan información, de lo contrario
cancelara 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 | Parametro Parámetro de entrada. |
cantKilosCartaPorte | Parametro Parámetro de entrada. |
Establecimiento | Parametro Parámetro de entrada. |
consumoPropio | Parametro 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).
Actualizara Actualizará el
status estatus de la lista de
empaque embarque para
Confirmación Arribo (NJJ_STACTP:='1')
Âncora |
---|
OLE_LINK11 | OLE_LINK11 | Âncora |
---|
OLE_LINK12 | OLE_LINK12 | y el codigo de operación que retorno el y el código de operación que retorno el WS (NJJ_COEARR=codigoOperacion).
Para la impresión del CTG
ingresara ingresará a la opción
Imprimir CTG confirmado, que se explica al final de este documento.
Si la respuesta es errónea,
notificara 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
validara validará que el registro seleccionado tenga status
Confirmacion confirmación de Arribo (NJJ_STACTP='1'), de lo contrario
enviara enviará al usuario el mensaje "Para Confirmación Definitiva , el CTG debe tener status de Confirmación de Arribo".
Si el status es
validoválido,
realizara 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 Confirmacion confirmación Arribo).
Al ingresar a esta opción
visualizara visualizará y
solicitara solicitará algunos datos como sigue (ver
prototipo 08):
Carta de Porte .- Solo se
visualizara visualizará y es obligatorio .
Numero Número de Carta de Porte del registro seleccionado (njj_carta).
C.T.G. .- Solo se
visualizara visualizará y es obligatorio . Código de Trazabilidad de Grano del registro seleccionado (njj_codctg).
Especie : Solo se
visualizaravisualizará. Se obtiene del resultado del método
ConsultarDetalleCTG del elemento
Especie. Cosecha : .- Solo se
visualizara visualizará Se obtiene del resultado del método
ConsultarDetalleCTG del elemento
Cosecha Peso Neto .-
ObligatorioEditable, valor en kilos.
Al seleccionar Confirmar, primero
validara 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 Âncora |
---|
OLE_LINK1 | OLE_LINK1 |
Método ConfirmarDefinitivo:
Solicitud de consulta:
Equivalencia de campos con PROTHEUS:
Campo | Protheus |
cartaPorte | NJJ_CARTA |
CTG | NJJ_CODCTG |
Especie | Parametro Parámetro de entrada |
Código Cosecha | Parametro Parámetro de entrada |
PesoNeto | Parametro Parámetro de entrada |
Respuesta de la consulta:
Si la respuesta de la consulta es exitosa enviara enviará al usuario el mensaje con los datos de la misma (ver
prototipo 09).
Y
actualizara actualizará el status de la lista de
empaque embarque a
Confirmación definitiva (NJJ_STACTP:='2'
Âncora |
---|
OLE_LINK13 | OLE_LINK13 | ) y el codigo de operación que retorno el WS (NJJ_COEDEF=codigoOperacion).
Si la respuesta es errónea
enviara enviará al usuario el mensaje de error reportado por la consulta (
ver Âncora |
---|
r10 | r10 | ver prototipo 10).
Sub opción Desviar CTG a otro Destino Al ingresar a esta opción,
validara validará que el
status Confirmacion de estatus Confirmación de Arribo (NJJ_STACTP='1'), de lo contrario
enviara enviará al usuario el mensaje "Para Desviar CTG a otro destino, debe tener
status estatus de Confirmación Arribo", e interrumpirá el proceso. Si el
status estatus es
valido visualizara válido visualizará y
solicitara solicitará algunos datos como sigue (ver
prototipo 11):
Carta de Porte .- Solo se visualizara visualizará y es obligatorio . Numero Número de Carta de Porte del registro seleccionado (njjNJJ_cartaCARTA).
C.T.G. .- Solo se visualizara visualizará y es obligatorio . Código de Trazabilidad de Grano del registro seleccionado (njjNJJ_codctgCODCTG).
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 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 | Parametro Parámetro de entrada. |
Localidad de PagoDestino | Parametro Parámetro de entrada. |
CUITDestino | Parametro Parámetro de entrada. |
Respuesta de la consulta:
Si la respuesta de la consulta es exitosa enviara enviará al usuario el mensaje con los datos de la misma (ver
prototipo 12).
Y
actualizara actualizará el status de la lista de
empaque embarque a
Desvio a otro destino (NJJ_STACTP:='3'
Âncora |
---|
OLE_LINK14 | OLE_LINK14 | Âncora |
---|
OLE_LINK15 | OLE_LINK15 | ) y el codigo de operación que retorno el WS (NJJ_COEDOD=codigoOperacion).
Si la respuesta es errónea
enviara 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,
validara validará que el status
Confirmacion confirmación de Arribo (NJJ_STACTP='1'), de lo contrario
enviara 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
valido visualizara válido visualizará y
solicitara solicitará algunos datos como sigue (
verver prototipo 13):
Carta de Porte .- Solo se
visualizara visualizará y es obligatorio .
Numero Número de Carta de Porte del registro seleccionado (
njjNJJ_
cartaCARTA).
C.T.G. .- Solo se
visualizara visualizará y es obligatorio . Código de Trazabilidad de Grano del registro seleccionado (
njjNJJ_
codctgCODCTG).
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 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 | Parametro Parámetro de entrada. |
Kms. a Recorrer | Parametro Parámetro de entrada. |
Localidad de PagoDestino | Parametro Parámetro de entrada. |
Respuesta de la consulta:
Si la respuesta de la consulta es exitosa enviara enviará al usuario el mensaje con los datos de la misma (ver
prototipo 14).
Y
actualizara actualizará el status de la lista de
empaque 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
enviara enviará al usuario el mensaje de error reportado (ver
prototipo 10).
Sub opción Rechazar CTG Al ingresar a esta opción, primero
validara validará que el registro seleccionado tenga status
valido válido (NJJ_STACTP='1'), de lo contrario
enviara enviará al usuario el mensaje "Para Rechazar CTG, desbe estar en status de Confirmado". Si el status es
validoválido,
visualizara visualizará y
solicitara solicitará algunos datos como sigue (
ver Âncora |
---|
r15 | r15 | prototipo ver prototipo 15):
Carta de Porte .- Solo se
visualizara visualizará y es obligatorio .
Numero Número de Carta de Porte del registro seleccionado (
njjNJJ_
cartaCARTA).
C.T.G. .- Solo se
visualizara visualizará y es obligatorio . Código de Trazabilidad de Grano del registro seleccionado (
njjNJJ_
codctgCODCTG).
Motivo : Texto obligatorio informando las causas del rechazo.
Al seleccionar Confirmar, primero
validara 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 | Parametro Parámetro de entrada. |
Respuesta de la consulta:
Si la respuesta de la consulta es exitosa enviara enviará al usuario el mensaje con los datos de la misma (ver
prototipo 16).
Y
actualizara actualizará el status de la lista de
empaque 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
enviara 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 validara validará que el registro seleccionado tenga status de rechazo (NJJ_STACTP='5'), de lo contrario enviara enviará al usuario el mensaje "Esta opción solo aplica si el CTG estacon status esta con estatus de rechazado". Si el status estatus es validoválido, visualizara visualizará y solicitara solicitará algunos datos como sigue (ver
prototipo 17):
Carta de Porte .- Solo se
visualizara visualizará y es obligatorio .
Numero Número de Carta de Porte del registro seleccionado (
njjNJJ_
cartaCARTA).
C.T.G. .- Solo se
visualizara visualizará y es obligatorio . Código de Trazabilidad de Grano del registro seleccionado (
njjNJJ_
codctgCODCTG).
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 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 |
Provincia Localidad de Destino | Parametro Parámetro de entrada |
Localidad de Destino | Parametro de entrada |
CUIT Destino | Parametro Parámetro de entrada |
CUIT Destinatario | Parametro Parámetro de entrada |
Km a recorrer | Parametro Parámetro de entrada |
Respuesta de la consulta:
Si la respuesta de la consulta es exitosa enviara enviará al usuario el mensaje con los datos de la misma (ver
prototipo 18).
Y
actualizara actualizará el status de la lista de
empaque embarque a
Desvio de destino y destinatario (NJJ_STACTP:='6'
Âncora |
---|
OLE_LINK16 | OLE_LINK16 | ) y el
codigo código de operación que retorno el WS (NJJ_COECDD=codigoOperacion).
Si la respuesta es errónea
enviara 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
validara validará que el registro seleccionado tenga status de rechazo (NJJ_STACTP='5'), de lo contrario
enviara enviará al usuario el mensaje "Esta opción solo aplica si el CTG esta rechazado". Si el status es
validoválido,
visualizara visualizará y
solicitara solicitará algunos datos como sigue (ver
prototipo 19):
Carta de Porte .- Solo se
visualizara visualizará y es obligatorio .
Numero Número de Carta de Porte del registro seleccionado (
njjNJJ_
cartaCARTA).
C.T.G. .- Solo se
visualizara visualizará y es obligatorio . Código de Trazabilidad de Grano del registro seleccionado (
njjNJJ_
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. CODCTG). Kms. a recorrer.- Obligatorio.
Al seleccionar Confirmar, primero validara 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 |
Provincia de Origen | Parametro de entrada |
CARTA |
CTG | NJJ_CODCTG | Localidad de Origen | Parametro de entrada |
Km a recorrer | Parametro Parámetro de entrada |
Respuesta de la consulta:
Si la respuesta de la consulta es exitosa enviara enviará al usuario el mensaje con los datos de la misma (ver prototipo
prototipo 18).
Y
actualizara actualizará el status de la lista de
empaque embarque Regreso a Origen (NJJ_STACTP:='7') y el
codigo código de operación que retorno el WS (NJJ_COEREG=codigoOperacion).
Si la respuesta es errónea
enviara 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
validara validará que el registro seleccionado tenga status
Confirmacion confirmación de Arribo (NJJ_STACTP='1'), de lo contrario
enviara 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
validoválido,
realizara 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
enviara 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
enviara enviará al usuario el mensaje de error reportado por la consulta .
...
- NJJ – Embalajes
- SA4 – Transportista
- NL0 – Carta de Porte
- SX5 – Tabla 12 y S1
Prototipo de Pantalla
Prototipo 01 Regresar
Prototipo 02 Regresar
|
Prototipo 03
Regresar |
Prototipo 04 [Regresar |
#r04]
Prototipo 05Regresar
|
Image Added Image Removed
Prototipo 06 Regresar |
Image Added Image Removed
Prototipo 07 Image RemovedRegresar
|
Image Added
Prototipo 08 Image RemovedRegresar Image Added |
Prototipo 09 Regresar |
Prototipo 10 Image RemovedRegresar
Image Added |
Prototipo 11Regresar |
Image Added Image Removed
Prototipo 12 [Regresar
|
#r12]
Prototipo 13Regresar
|
Image RemovedImage Added Prototipo 14Regresar
|
Prototipo 15 Image RemovedRegresar
|
Image Added Prototipo 16Regresar
|
Prototipo 17 Image RemovedRegresar Image Added
|
Prototipo 18 Regresar
Prototipo 19 Regresar |
Image Added Image Removed 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 |
...
Campo | NJJ_COEARR |
Tipo | C |
Tamaño | 8 |
Título | COE Conf Arrib |
Descripción | COE Confirmacion confirmación de arribo |
Picture | @! |
Contexto | Real |
Propiedad | Visualizar |
Usado | No |
Browse | Si |
Help de Campo | Codigo de Operación Electrónico de Confirmacion confirmación de Arribo |
Campo | NJJ_COEDEF |
Tipo | C |
Tamaño | 8 |
Título | COE Conf Def. |
Descripción | COE Confirmacion confirmación definitiva |
Picture | @! |
Contexto | Real |
Propiedad | Visualizar |
Usado | No |
Browse | Si |
Help de Campo | Codigo de Operación Electrónico de Confirmacion confirmación definitiva |
...