Skip to content

Documentación correos #305

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
wants to merge 6 commits into
base: master
Choose a base branch
from
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Binary file added docs/base/_static/correos/asdfsd.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added docs/base/_static/correos/crear_remesa_01.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added docs/base/_static/correos/crear_remesa_02.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added docs/base/_static/correos/estats_recepcio.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added docs/base/_static/correos/lin_rem.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added docs/base/_static/correos/line_form.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added docs/base/_static/correos/sicer_workflow.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added docs/base/_static/correos/wiz_imp_res_1.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added docs/base/_static/correos/wiz_lin_rem_an.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added docs/base/_static/correos/wiz_lin_rem_an_2.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added docs/base/_static/correos/wiz_lin_rem_an_3.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
124 changes: 124 additions & 0 deletions docs/base/correos-esp/correos-funcionament-integracio.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,124 @@
# Integració i funcionament del sistema de Correos a l'ERP

## Descripció general del funcionamient del sistema de remeses


## Composició d'una remesa

## Crear una remesa
Desde **Menú→Correos→Remeses de correos** s'accedeix al menú de
remeses.

![](../_static/correos/crear_remesa_01.png)

![](../_static/correos/crear_remesa_02.png)

### Camps d'una remesa

- ***Nom***: Codi identificatiu de la remesa.
- ***Usuari***: Usuari que ha creat la remesa.
- ***Data d'enviament***: Data en la que s'ha enviat la remesa per ser processada.
- ***Estat de la remesa***: Estat actual de la remesa dins l'ERP (esborrany, enviament, tancada)
- ***Estat de la remesa de correus***: Estat de la remesa segons correus (bloquejada, oberta, tancada), aquest estat s'anira actualitzant segons l'estat relatiu a Correos.
- ***Data de tancament***: Data en la que s'ha tancat la remesa.
- ***Total línies***: Número de línies que componen la remesa.

## Afegir factures a una remesa
Per afegir factures a una remesa es pot fer desde el botó d'accions del llistat
de factures (***Facturacio→Factures...***) o desde el menú de comptabilitat (***Comptabilitat i finances→Factures...***)

**Pas 1: (Accions→Afegir a remesa de correus)**

Per afegir les factures a una remesa concreta s'han de seleccionar les que es vulguin afegir i desde el menú d'accions seleccionar l'assistent.

![](../_static/correos/añadir_lineas_remesa.png)

**Pas 2: Selecció de la remesa**

![](../_static/correos/wiz_lin_rem_an.png)

**Pas 3: Informació relativa a les factures que s'afegiran**
Si s'esta d'acord en afegir les factures a la remesa s'ha de clicar el boto
***Crear Línies***

![](../_static/correos/wiz_lin_rem_an_2.png)

**Pas 4: Informació resultant de la importació**

En aquest pas es mostra la informació relativa al resultat de la importació a la remesa, si alguna cosa no ha anat correctament indicarà per a quines factures ha fallat.

![](../_static/correos/wiz_lin_rem_an_3.png)

## Línies importades
Un cop importades les factures s'hauran generat un seguit de línies a la remesa
corresponents a les factures.

![](../_static/correos/lin_rem.png)

### Camps d'una línia
![](../_static/correos/line_form.png)

**Informació de la línia**
(Informació relativa a la línia i control de seguiment)
- ***Remesa***: Codi identificatiu de la remesa.
- ***Seqüencia***: Número de la línia (requerit per la generació del codi SICER).
- ***Factura***: Número de la factura d'origen de la línia .
- ***Estat pendent***: Estat pendent de la factura original (
referent al bono social).
- ***Codi SICER***: Codi únic identificatiu per el seguiment.

**Estat de recepció**
(Informació relativa a l'estat de recepció de la carta)
- ***Data de recepció***: Data d'entrega al client.
- ***Estats de l'enviament***: Detall de l'enviament.
![](../_static/correos/estats_recepcio.png)

- ***Enregat?***: Aquest camp esterà marcat si s'ha pogut entregar correctament
la carta al client.

**Informació del destinatari**
(Informació relativa al client)
- ***Empresa***: Empresa/client destí
- ***Direcció***: Direcció de destí.
- ***Ciutat***: Ciutat del destinetari.
- ***Codi postal***: Codi postal de la ciutat del destinetari


## Assistent per a la importació de fitxers de resultats
Aquest assisten permét importar els fitxers resultats dels enviaments de les remeses emesos per **Correos**

![](../_static/correos/correos_loc_wiz_importacio_resultats.png)

**Pas 1: (Seleccio del fitxer de resultats)**

En el primer pas s'ha de seleccionar el fitxer de resultats que es vol importar.
Un cop seleccionat mitjançant el botó importar i actualitzar es procesara el fitxer i s'actualitzaran les linies de les remeses que siguin possibles.

![](../_static/correos/wiz_imp_res_1.png)

**Pas 2: (Resultat d'actualització)**

En el segon pas tindrem dos possibilitats:

1. Alguna linia no s'ha pogut processar/actualitzar (**Errors**)

2. Totes les linias s'han pogut processar

Un com processat el fitxer amb el boto **Remesas actualitzades** s'accedeix a la
llista de remeses que s'han actualitzat.

**Pas 2.1: (Importació amb errors)**

En el cas qua alguna línia no s'hagi pogut processar es generara un fitxer ***CSV*** amb la informació corresponent a aquestes, i les que si que es puguin processar s'actualitzaran seguint el procés normal.

![](../_static/correos/importacio_resultats_errors.png)

![Fitxer d'errors](../_static/correos/importacio_resultats_file_errors.png)


**Pas 2.2: (Importació sense errors)**

En el cas que totes les linies s'hagin pogut processar correctament es mostrara
el següent missatge que indica.

![](../_static/correos/importacio_resultats_correcte.png)
73 changes: 73 additions & 0 deletions docs/base/correos-esp/correos.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,73 @@
# Documentació del mòdul de Correos (Espanya)
[//]: <> (![](../_static/correos/logo-correos.png))

## Introducció
El mòdul de correos permet a GISCE-ERP la gestió de l'enviament de remeses (**conjunt de factures**) i intercanvi de fitxers entre els clients i Correos a través dels seus formats i codis **SICER**.
Aquests fitxers venen definits per **CORREOS ESPAÑA**.

## Conceptes i funcionament

### SICER

**SICER** (**S**istema d'**I**nformació i **C**ontrol dels **E**nviaments **R**egistrats)

<p align="center">
![](../_static/correos/sicer_workflow.png)
</p>


#### Pas 1 (Client&rarr;Correos)

**CLIENT > SICER > GESTIÓ DE L'ENTREGA > GESTIÓ DELS ENVIAMENTS AMB
REEMBORSAMENT**

***SICER*** posa a la disposició d'altres sistemes de **Correos** la informació
la informació relativa als seus enviaments que proporcionen els seus clients.

Aquesta informació dona suport als diferents processos operatius de distribució
i entrega, així com la gestió de reemborsaments.

#### Pas 2 (Correos&rarr;Client)

**RESULTATS DE L'ENTREGA > PAGAMENTS REALITZATS (REEMBORSAMENT) > SICER > CLIENT**

En el sentit contrari, ***SICER*** recull els resultats de l'entrega i els pagaments realitzats d'enviaments amb la modelitat de reemborsament, remetent periòdicament aquesta informació al client.


### Remesa

Una remesa identifica la agrupació d'enviaments que diposita un client de forma conjunta per a la seva distribució.

El client determina el número d'enviaments que formen una remesa. Amb aquests
enviaments, agrupats en una o varies remeses, generara un fitxer segons l'estructura especificada a la secció ($$$$$TODO$$$$)

Una remesa s'inicia en el moment que es rep el fitxer de dades ($$$$$TODO$$$$) abans del diposit fisic dels enviaments i es tenca quan es determina que ha finalitzat el proces de distribució i es te constancia dels events d'entrega d'aquests.

Durant tot el proces descrit una remesa passa per els següents estats:

- **Bloquejada**: Informació rebuda i carregada en el sistema **SICER** a la espera de que es faci el dipósit fisic dels enviaments.


- **Oberta**: Periode d'actualitzacións dels enviaments que conformen la remesa.


- **Tancada**: Fi del periode d'actualitzacions del enviaments de les remeses.

Durant el process de remesar la remesa també pasa per els seguents estats a l'ERP:

- **Esborrany**: Estat inicial de la remesa.

- **Enviament**: Indica que la remesa es troba en estat d'enviament.

- **Finalitzada**: Indica que l'enviament de la remesa ha finalitzat.

- **Tancada**: Dona la remesa per finalitzada.

**Possibles canvis d'estat (Workflow):**

| | Esborrany | Enviament | Finalitzada | Tancada |
|-----------------|:---------:|:---------:|:-----------:|:-------:|
| **Esborrany** | | x | | x |
| **Enviament** | | | x | x |
| **Finalitzada** | | | x | |
| **Tancada** | | | | ||
4 changes: 4 additions & 0 deletions mkdocs.yml
Original file line number Diff line number Diff line change
Expand Up @@ -46,6 +46,10 @@ pages:
- Automatització de prosessos: base/ges-atr/automatitzacio.md
- Apèndix: base/ges-atr/apendix.md
- SOA: base/soa.md
- Correos:
- Introducció i conceptes: base/correos-esp/correos.md
- Integració i funcionament: base/correos-esp/correos-funcionament-integracio.md
- Format de fitxers: base/correos-esp/formats-fitxers.md
- Distribuidora:
- Inici: distri/index.md
- SOA: distri/soa.md
Expand Down
4 changes: 4 additions & 0 deletions mkdocs_es.yml
Original file line number Diff line number Diff line change
Expand Up @@ -49,6 +49,10 @@ pages:
- Automatitzación de procesos: base/ges-atr/automatitzacio.md
- Apéndice: base/ges-atr/apendix.md
- SOA: base/soa.md
- Correos:
- Introducción y conceptos: base/correos-esp/correos.md
- Integración y funcionamiento: base/correos-esp/correos-funcionament-integracio.md
- Formato de ficheros: base/correos-esp/formats-fitxers.md
- Distribuidora:
- Inicio: distri/index.md
- SOA: distri/soa.md
Expand Down