![loading](../images/custom-img/loading-articol.gif)
Import rezervari hotel
Importul rezervarilor se realizeaza in doua etape:
- Inserarea in tabelele de antete si linii a informatiilor corecte si complete. In cazul in care se doreste importul simultan pentru mai multe documente se foloseste pentru legatura dintre antet si linii campul id_document. Structura tabelelor este prezentata in anexele B si C.
- Apelarea procedurii stocate importex_rezervari_hotel_exec care valideaza, importa datele si goleste tabelele-buffer. In cazul in care datele nu sunt corecte procedura intoarce o exceptie si intregul proces de import este abandonat, restabilindu-se starea dinaintea importului. Lista erorilor posibile este prezentata in anexa D.
Anularea unui import se face prin apelarea procedurii stocate importex_rezervari_hotel_anulare cu parametrul id_importex (id lot articole importate), dar si prin id_document (id-ul extern din aplicatia terta). Procedura stocata verifica consistenta efectului de anulare a datelor deja importate si dupa caz realizeaza stergerea efectiva a datelor sau intoarce un mesaj de eroare.
Puteti consulta urmatoarele tabele pentru a verifica, in prealabil sau ulterior importului, datele existente:
- Antete de documente: ht_cazari. Cheia primara a tabelului: pct_lcr + id.
- Linii de documente pentru produse: ht_cazari_linii. Legatura cu antetul pl_caz + id_caz.
ANEXA A. Parametri import:
Câmp | Tip | Descriere |
---|---|---|
id_importex | varchar(25) | ID pentru identificarea unui lot de documente importate (util, de ex., pentru ștergerea în bloc a unui lot de documente importate), valoare implicită NULL |
id_document | varchar(25) | ID-ul documentului care se dorește a fi importat. În cazul în care se dorește importul tuturor documentelor se va trimite NULL. Valoarea implicită este NULL. |
keep_data_on_err | bit | 0 - nu se vor păstra datele în tabelele buffer (valoare implicită) 1 - se vor păstra datele în tabelele buffer, în caz de eroare |
manage_existing | tinyint | 0 - Blochează - procedura se oprește, returnând o eroare (valoare implicită) 1 - Suprascrie - se actualizează datele rezervarii existente 2 - Ignoră - se ignoră importul înregistrării curente, lăsând datele rezervarii neschimbate |
updated_columns | varchar(max) | Se va trimite lista de câmpuri ce se doresc a fi suprascrise, separate prin virgulă (fără spațiu între câmpuri și virgulă), implicit NULL |
single_tran | bit | Se specifică dacă se va deschide o singură tranzacție pentru întregul import sau se va utiliza o tranzacție per document. 1 - în cazul apariției unei erori la importul unui document, sistemul va reveni complet la starea dinaintea importului (valoare implicită). 0 - documentele importate până la apariția erorii rămân în baza de date |
exec_type | tinyint | 0 - Validare și import, cu oprire în cazul erorilor (valoare implicită) 1 - Validare și import, sărind peste înregistrările cu erori 2 - Validare date, fără a realiza importul |
return_errorlist | tinyint | 0 - Fără listă erori (valoare implicită) 1 - Returnează lista înregistrărilor cu erori 2 - Returnează lista tuturor înregistrărilor |
search_mode | tinyint | 0 - Caută după serie, număr, data document (valoare implicită) 1 - Caută după id_document (id_extern) |
ANEXA B. Tabel antete document: importex_rezervari_hotel avand structura:
Coloana | Tip | Descriere |
---|---|---|
id_importex | varchar(25) | ID pentru identificarea unui lot de documente importate (util, de ex., pentru stergerea in bloc a unui lot de documente importate) Atentie! Gestionarea, verificarea si validarea acestui camp este in sarcina dezvoltatorului utilitarului de export-import. |
id_document | varchar(25) | ID unic pentru identificarea documentului |
id_carnet | bigint | Codul intern al carnetului din care este emis documentul (optional) |
tip_document | varchar(15) | Tipul documentului, avand una dintre valorile: "Rez. grup" pentru rezervarea de grup; "Rez.camera grup" rezervarea unei camere in cadrul grupului; "Rez. individuala"pentru rezervarea individuala a unei camere. |
serie_document | varchar(10) | Seria documentului (optional) |
numar_document | varchar(20) | Numarul documentului |
data_document | date | Data documentului |
id_cladire | varchar(25) | Codul intern al cladirii in formatul ID(PCT_LCR). Daca se specifica doar ID-ul, atunci punctul de lucru este considerat implicit 1 (optional daca se specifica den_cladire) |
den_cladire | varchar(100) | Denumirea cladiri (optional daca se specifica id_cladire) |
id_client | varchar(25) | Codul intern al clientului in formatul ID(PCT_LCR). Daca se specifica doar ID-ul, atunci punctul de lucru este considerat implicit 1 (optional daca se specifica cif_client, id_extern_client sau den_client) |
id_extern_client | varchar(50) | Id-ul extern al partenerului (optional daca se specifica id_client, cif_client, den_client) |
cif_client | varchar(20) | Codul fiscal / CNP al clientului (optional daca se specifica id_client sau den_client) |
den_client | varchar(100) | Denumirea clientului (optional daca se specifica id_client sau cif_client) |
id_delegat | varchar(25) | Codul intern al delegatului in formatul ID(PCT_LCR). Daca se specifica doar ID-ul, atunci punctul de lucru este considerat implicit 1 (optional daca se specifica den_delegat) |
id_extern_delegat | varchar(25) | Id-ul extern al delegatului (optional daca se specifica id_delegat sau den_delegat) |
den_delegat | varchar(60) | Denumirea delegat (optional daca se specifica id_delegat sau id_extern_delegat) |
id_camera | varchar(25) | Codul intern al camerei (optional daca este rezervare de grup si nr_camere > 1) |
id_tip_camera | varchar(25) | Id-ul tipului de camera (optional daca se specifica den_tip_camera sau sigla_tip_camera sau rezervarea este de tip individuala) |
den_tip_camera | varchar(100) | Denumirea tipui de camera (optional daca se specifica id_tip_camera sau sigla_tip_camera sau rezervarea este de tip individuala) |
nr_camera | varchar(5) | Numarul camerei(optional daca este rezervare de grup si nr_camere > 1) |
sigla_tip_camera | char(3) | Sigla tipului de camera |
id_agentie | varchar(25) | Codul intern al agentiei in formatul ID(PCT_LCR). Daca se specifica doar ID-ul, atunci punctul de lucri este considerat implicit 1 (optional daca se specifica den_agentie sau id_extern_agentie) |
id_extern_agentie | varchar(25) | Id-ul extern al agentiei (optional daca se specifica id_agentie sau den_agentie) |
den_agentie | varchar(100) | Denumirea agentiei (optional daca se specifica id_agentie sau id_extern_agentie) |
status_cazare_tip | tinyint | ID status rezervare(optional daca se specifica statusul cazarii). Campul poate lua una din valorile: 1 = Cazare 2 = Mentenanta 3 = Check-Out 4 = Rezervare 5= Rezervare provizorie |
status_cazare | varchar(50) | Denumire status rezervare(Optional daca se specifica status_cazare_tip). Campul poate lua una dintre valorile:"Cazare", "Mentenanta", "Check-Out","Rezervare","Rezervare provizorie" |
oaspete | varchar(200) | Numele oaspetelui (Obligatoriu daca statusulrezervarii este Cazare sau Check-Out) |
telefon | varchar(50) | Numarul de telefon al oaspetelui (optional) |
varchar(50) | Adresa de email a oaspetelui (optional) | |
nr_pers | smallint | Numarul de persoane (optional) |
data_start | date | Data de inceput a rezervarii |
data_stop | date | Data de sfarsit a rezervarii |
data_ckin | date | Data sosirii efective a oaspetelui la receptia unitatii (obligatoriu daca status_cazare este Cazare) |
data_ckout | date | Data de inchidere a cazarii si eliberarea camerei (Obligatoriu daca status_cazare este Cazare sau Check-Out) |
observatii | varchar(2000) | Observatii (optional) |
id_grup | varchar(25) | Codul intern al cazarii de grup in formatul ID(PCT_LCR). Daca se specifica doar ID-ul, atunci punctul de lucru este considerat implicit 1 (optional daca se specifica cod_grup) |
cod_grup | varchar(100) | Codul grupului reprezinta un numar de identificare unic al cazarilor cuprinse intr-un grup. |
nr_camere | numeric(18,0) | Numarul de camere incluse in grup. Pentru rezervarile individuale valoarea default este 1. |
validare | bit | Se va valida sau nu documentul dupa salvare |
anulare | bit | Se va anula sau nu documentul dupa salvare |
nr_copii | tinyint | Numarul de copii (optional) |
identificator | varchar(50) | Informatii referitoare la numarul rezervarii efectuate intr-o aplicatie externa(ex: booking) |
id_gestiune_antet | varchar(25) | Codul intern al gestiunii in formatul ID(PCT_LCR). Daca se specifica doar ID-ul, atunci punctul de lucru este considerat implicit 1 (optional daca se specifica den_gestiune_antet). Doar in cazul in care tip_document e "Rez. grup" |
den_gestiune_antet | nvarchar(30) | Denumirea gestiunii. Doar in cazul in care tip_document e "Rez. grup" (optional daca se specifica id_gestiune_antet) |
ANEXA C. Tabel linii: importex_rezervari_hotel_lin avand structura:
Coloana | Tip | Descriere |
---|---|---|
id_document | varchar(25) | ID unic pentru identificarea documentului |
id_gestiune | varchar(25) | Codul intern al gestiunii in formatul ID(PCT_LCR). Daca se specifica doar ID-ul, atunci punctul de lucru este considerat implicit 1 (optional daca se specifica den_gestiune) |
den_gestiune | varchar(30) | Denumirea gestiunii (optional daca se specifica id_gestiune) |
id_cmd | varchar(25) | Codul intern al comenzii in formatul ID(PCT_LCR). Daca se specifica doar ID-ul, atunci punctul de lucru este considerat implicit 1 (optional daca se specifica numar_cmd) |
numar_cmd | numeric(18,0) | Numarul comenzii (pentru gruparea serviciilor) |
tip_doc_incasare | varchar(25) | Tipul documentului de incasare. Poate fi Factura sau Bon fiscal |
tip_incasare | varchar(1) | Optional daca se specifica tip_doc_incasare |
tip_produs | varchar(3) | Codul din 3 caractere corespunzator tipului de produs definit in nomenclatorul de bunuri si servicii (optional daca se specifica cont_produs) |
id_produs | varchar(25) | Codul intern al produsului in formatul ID(PCT_LCR). Daca se specifica doar ID-ul, atunci punctul de lucru este considerat implicit 1 (optional daca se specifica cod_produs sau den_produs) |
id_extern_produs | varchar(25) | Id-ul extern al produsului (optional daca se specifica id_produs sau den_produs) |
cod_produs | varchar(20) | Codul de bare al produsului (optional daca se specifica id_produs sau den_produs) |
den_produs | varchar(231) | Denumirea produsului (optional daca se specifica id_produs sau cod_produs) |
cont_produs | varchar(17) | Contul produsului (optional daca se specifica tip_produs) |
den_tip_srv | varchar(50) | Tipul de servicii posibile: Serviciu de baza, Serviciu secundar, Serviciu optional. Optional daca se specifica tip_srv. Implicit va fi Serviciu de baza |
tip_srv | tinyint | Pentru tipul de servicii utilizati una din variantele:1 = Serviciu de baza, 2 = Serviciu secundar, 3 = Serviciu optional(optional daca se specifica den_tip_srv). Implicit va fi 1 |
cantitate | numeric(13,3) | Cantitatea |
pret_achizitie | money | Pretul de achizitie (optional) |
pret_vanzare | money | Pretul de vanzare fara TVA (optional daca se specifica pret_vanzare_tva) |
pret_vanzare_tva | money | Pretul de vanzare cu TVA(optional daca se specifica pret_vanzare) |
cota_tva_ies | numeric(2,0) | Cota TVA iesire (optional, implicit e preluata din nomenclator) |
id_centru_profit | varchar(25) | Codul intern al centrului de profit in formatul ID(PCT_LCR). Daca se specifica doar ID-ul, atunci punctul de lucru este considerat implicit 1 (optional daca se specifica den_centru_profit) |
den_centru profit | nvarchar(100) | Denumirea centrului de profit (optional daca se specifica id_centru_profit) |
id_extern_centru_profit | varchar(25) | Id-ul extern al centrului de profit (optional daca se specifica id_centru_profit sau den_centru_profit) |
data_cazare | date | Se va completa data (ziua) din perioada de cazare pentru care este disponibil serviciul. Daca serviciul se multiplica cu numarul de zile aferent cazarii, atunci se va introduce cate o linie pentru fiecare zi de cazare din perioada cazarii. Altfel, data nu va fi specificata la import. |
ANEXA D. Tabel erori posibile la importul rezervarilor hoteliere:
Coloana | Descriere |
---|---|
HT001 | Lipsa date (tabelul de import nu are nicio inregistrare) |
HT002 | Numar nespecificat |
HT003 | Client nespecificat |
HT004 | Data de inceput nespecificata |
HT005 | Data de sfarsit nespecificata |
HT006 | Cladire nespecificata |
HT007 | Camera nespecificata |
HT008 | Urmatoarele coduri de carnet nu exista in nomenclator |
HT009 | Data sfarsit este anterioara datei de inceput |
HT010 | Produs nespecificat |
HT011 | Lipsa antet |
HT012 | Urmatoarele coduri fiscale nu identifica unic clientul |
HT013 | Urmatoarele coduri fiscale nu identifica unic clientul. |
HT014 | Urmatoarele denumiri nu identifica unic clientul. |
HT015 | Lipsa client in nomenclator |
HT016 | Urmatoarele id-uri externe nu identifica unic agentia |
HT017 | Urmatoarele denumiri nu identifica unic agentia |
HT018 | Lipsa agentie in nomenclator |
HT019 | Urmatoarele id-uri externe nu identifica unic delegatul |
HT020 | Urmatoarele denumiri nu identifica unic delegatul |
HT021 | Lipsa delegat in nomenclator |
HT022 | Urmatoarele denumiri nu identifica unic cladirea |
HT023 | Urmatoarele denumiri nu identifica unic tipul de camera. |
HT024 | Urmatoarele coduri ale camerei nu identifica unic tipul de camera. |
HT025 | Lipsa tip camera in nomenclator. |
HT026 | Nume oaspete nespecificat. |
HT027 | Numar camere incluse in grup nespecificat. |
HT028 | Data de check-in nespecificata pentru rezervare de tip cazare. |
HT029 | Data de check-in / check-out nespecificata pentru rezervare de tip check-out. |
HT030 | Exista linii cu pret de achizitie negativ |
HT031 | Exista linii cu pret de vanzare negativ |
HT032 | Urmatoarele conturi sunt invalide |
HT033 | Urmatoarele conturi nu identifica unic tipul in nomenclatorul de bunuri si servicii |
HT034 | Lipsa pozitie in nomenclator bunuri si servicii |
HT035 | Urmatoarele coduri nu identifica unic produsul dupa cod extern |
HT036 | Urmatoarele coduri nu identifica unic produsul dupa cod selectie |
HT037 | Urmatoarele coduri nu identifica unic produsul dupa cod echivalent |
HT038 | Urmatoarele id-uri externe nu identifica unic produsul |
HT039 | Urmatoarele denumiri nu identifica unic produsul |
HT040 | Lipsa produs in nomenclator |
HT041 | Urmatoarele denumiri nu identifica unic centrul de profit |
HT042 | Lipsa centru de profit in nomenclator |
HT043 | Urmatoarele denumiri nu identifica unic gestiunea |
HT044 | Lipsa gestiune in nomenclator |
HT045 | Urmatoarele denumiri nu identifica unic camera |
HT046 | Urmatoarele nr de camera nu exista in nomenclator sau nu corespund tipului de camera sau cladirii |
HT047 | Tip document : Tip de camera nespecificat. |
HT048 | Document deja existent |
HT049 | Urmatoarele denumiri nu identifica unic codul grupului |
HT050 | Cantitatea serviciului trebuie sa fie mai mare decat 0. |
HT051 | Nu exista o rezervare de grup care sa corespunda codului de grup |
HT052 | Urmatoarele statusuri nu exista in nomenclator |
HT053 | Documentul are asociate plati (diferite de avansuri). |
HT054 | Check-IN in afara perioadei rezervate. |
HT055 | Check-OUT in afara perioadei rezervate |
HT056 | Check-OUT-ul trebuie sa fie ulterior Check-IN-ului |
HT057 | Rezervarile au perioade de inchiriere care se suprapun pentru aceeasi camera |
HT058 | Documentul este o rezervare de grup si are asociate rezervari cu linii facturate si nu poate fi sters |
HT059 | Tip document nespecificat. |
HT060 | Tipul documentului trebuie sa fie: "Rez. grup", "Rez.camera grup" sau "Rez.individuala" |
HT061 | Tip document : "Rezervare de grup" : Cod grup nespecificat. |
HT062 | Tip document : "Rezervare de grup" : Tip de camera nespecificat! |
HT063 | Tip document : "Rezervare de grup" : Numar de camere incluse in grup nespecificat! |
HT064 | Tip document : "Rezervare de grup" : Numarul camerei nu trebuie specificat pentru rezervarile de grup! |
HT065 | Tip document : "Rezervare camera in grup" : Cod grup sau id_grup nespecificat. |
HT066 | Urmatoarele id-uri externe nu identifica unic centrul de profit |
HT067 | Urmatoarele numere de comanda nu identifica unic comanda |
HT068 | Sesiunea documentului a fost blocata la modificari! |
HT069 | Sesiunea documentului depaseste sesiunea curenta! |
HT070 | Data cazare in afara perioadei de cazare. |
HT071 | Data cazare in afara perioadei de cazare a grupului. |
HT072 | Tip document : "Rezervare de grup": Gestiune nespecificata! |
HT073 | Urmatoarele denumiri nu identifica unic gestiunea de pe antet |
HT074 | Lipsa gestiune antet in nomenclator |