Błędy i ostrzeżenia DocuSign / Yousign Bridge w Odoo: jeden przypadek od początku do końca

Zmyślony przypadek, na którym przejdziemy przez ostrzeżenia

Przykład Przypadek poglądowy: firma i jej dane są zmyślone, żeby pokazać przebieg.

Gestoría Marlet to zmyślone biuro rachunkowe, które chce podpisywać umowy o świadczenie usług bezpośrednio z Odoo: na co dzień przez Yousign, a przez DocuSign dla jednego klienta, który tego wymaga. Laura, kierowniczka administracji, jest managerem Signature Bridge; Pau z jej zespołu przygotowuje wnioski o podpis. W firmie obowiązuje polityka EU-only, którą sprawdza moduł. Śledzimy, co im się przydarza i jaki komunikat pojawia się na każdym etapie. Teksty podajemy dokładnie tak, jak wyświetla je moduł, po angielsku.

Gdy Pau dotyka czegoś zarezerwowanego dla managerów

Pau otwiera formularz dostawcy DocuSign, żeby zmienić ustawienie, i dostaje Only a Signature Bridge manager can do this on a provider. To nie błąd: ta akcja jest zarezerwowana dla managerów Signature Bridge, więc wykonuje ją Laura.

Tak samo jest ze stanem mostu: Only Signature Bridge managers can read its health. I ze wskaźnikami: Only Signature Bridge managers can refresh the KPIs. Jeśli ktoś z zespołu potrzebuje tych zadań, nadaj mu rolę managera; w przeciwnym razie niech zajmie się nimi osoba, która już ją ma.

Jeśli typ dostawcy nie jest obsługiwany przez moduł, ostrzeżenie brzmi Unsupported provider type: %s, a w miejscu %s pojawia się typ.

Konto DocuSign: region, dostawca podpisu i DPA

Pau próbuje wysłać pierwszy wniosek przez DocuSign, a moduł go zatrzymuje komunikatem EU-only policy: the data center of %s is not known yet. Run "Test Connection" on the provider so DocuSign reports the region of the account. Sam komunikat mówi, co zrobić: Laura uruchamia Test Connection u dostawcy, żeby DocuSign podał region konta.

Jeśli zwrócony region leży poza UE, ostrzeżenie zmienia się na EU-only policy: the %(provider)s account is hosted in region "%(region)s", outside the EU. Przy polityce EU-only moduł nie pozwala dalej pracować z tym kontem: trzeba ustalić z dostawcą, w jakim regionie jest ono hostowane.

Kolejna blokada w formularzu: Choose the DocuSign %s signature provider of the account on the provider form (Test Connection lists them). Laura wybiera w formularzu dostawcy dostawcę podpisu DocuSign przypisanego do jej konta; Test Connection pokazuje, jakie są dostępne.

Przed wysyłką w środowisku produkcyjnym pojawia się Confirm the Data Processing Agreement with %s before sending in production. Moduł wymaga potwierdzenia umowy powierzenia przetwarzania danych z tym dostawcą i dopóki nie zostanie potwierdzona, nie wysyła niczego produkcyjnie.

Webhooki i klucz HMAC DocuSign

Przy DocuSign jednym z ostrzeżeń, które widzi Laura, jest DocuSign webhooks are declared on every envelope (eventNotification); paste the Connect HMAC key in "Webhook Secret". Innymi słowy: w DocuSign webhooki deklaruje się w każdej kopercie, a jej zadaniem jest wkleić klucz HMAC z Connect w pole Webhook Secret.

Drugie ostrzeżenie dotyczące klucza wyjaśnia, gdzie się go tworzy: DocuSign Connect HMAC keys are generated in DocuSign (Settings > Connect > HMAC Keys): create a new key there and paste it in "Webhook Secret". Klucz generuje się w DocuSign, w Settings > Connect > HMAC Keys, i wkleja w Webhook Secret.

W innym momencie moduł może zażądać Register the webhook first. Zarejestruj webhook i powtórz akcję. A jeśli przyjdzie webhook z treścią, która nie jest poprawnym JSON-em, moduł odrzuci go komunikatem Invalid webhook JSON payload; sprawdź u dostawcy, jak skonfigurowany jest ten webhook.

Pau przygotowuje wniosek

Pau tworzy wniosek dla umowy o świadczenie usług. Przy zapisie bez podpisujących pojawia się At least one signer is required., a bez dokumentu At least one document attachment is required. Dodaje podpisującego i załącza umowę.

Umowa jest w Wordzie, a wniosek idzie przez Yousign: Yousign signs PDF documents: %s is not a PDF. Yousign podpisuje dokumenty PDF, więc Pau konwertuje plik i załącza go ponownie.

Następnie wybiera poziom, na który ten dostawca nie pozwala: Level %(level)s is not allowed on provider %(provider)s. Zmienia poziom albo dostawcę. Dla klienta, który wymaga QES, pojawia się QES is not available on %s: run "Test QES Capability" on the provider. Laura uruchamia Test QES Capability u dostawcy.

Wysyłka i to, co dzieje się potem

Pau klika Send. Oto ostrzeżenia na tym etapie:

• Only draft requests can be sent. Wysłać można tylko wnioski w wersji roboczej.
• DocuSign answered without an envelopeId. i Yousign answered without a signature request id. Odpowiedź dostawcy nie zawierała identyfikatora koperty ani wniosku o podpis. Zanim powtórzysz wysyłkę, sprawdź na koncie dostawcy, co się z nią stało.
• The level and the provider of a signature request are fixed once it is sent. Poziom i dostawca zostają zablokowane w chwili wysyłki: ustal je przed kliknięciem Send.
• Only Send links a signature request to an envelope of the provider. Powiązanie z kopertą dostawcy tworzy wyłącznie Send.
• A signature request starts as a draft: only the provider moves its state. i Only the provider and the buttons of the request move its state. Stanu nie zmienia się ręcznie: przesuwają go dostawca i przyciski wniosku.

Kilka dni później Pau chce przypomnieć o podpisie. Jeśli wniosek nie jest aktywny: Only active requests can be reminded. Jeśli wszyscy podpisujący już podpisali lub odmówili: Every signer has already signed or declined. Przy Yousign może pojawić się Yousign signer ids are unknown for: %s, wskazujące podpisujących, których identyfikatora Yousign moduł nie zna; sprawdź ten wniosek w Yousign. A jeśli wniosek jest już zamknięty: %s is already closed.

Klient odrzuca umowę, a Pau chce wysłać ją ponownie w nowej wersji. Klonować można tylko wnioski wygasłe lub odrzucone: Only expired or declined requests can be cloned.

Dowód podpisu i dziennik audytu

Jeśli Pau szuka dowodu za wcześnie, moduł odpowiada Evidence exists once %s is completed. Dowód istnieje dopiero po zakończeniu wniosku.

Po zakończeniu dowodu nie da się edytować: Completed signature evidence cannot be modified. Usuwanie go należy do managerów i zostawia ślad: Only Sign Bridge Managers can delete completed evidence, and deletion is audited.

Do zdarzeń audytu można tylko dopisywać rekordy. Jeśli ktoś próbuje je zmienić, komunikat brzmi Audit events are append-only.

Czego uczy przypadek Marlet

• Czytaj cały komunikat: wiele z nich wskazuje przycisk (Test Connection, Test QES Capability) albo pole (Webhook Secret), które usuwa blokadę.
• Dobrze rozdziel role: dostawca, stan mostu, KPI i usuwanie dowodów to zadania managerów Signature Bridge.
• Przed Send sprawdź podpisującego, załącznik, format PDF przy Yousign, dozwolony poziom i potwierdzoną umowę DPA.
• Po wysyłce poziom i dostawca są zablokowane, a stan przesuwają dostawca i przyciski.
• Zakończonych dowodów i zdarzeń audytu się nie edytuje.

Jeśli jesteś w trakcie wdrożenia, przewodnik po ustawieniach i pierwszym tygodniu omawia pola, które trzeba wypełnić.

Jak pomaga FlexigoTech

FlexigoTech wdraża Odoo 17, 18, 19 i 20 oraz tworzy konektory i integracje na zamówienie, także w obszarze podpisu elektronicznego. Moduł jest opublikowany w Odoo Apps dla wersji 17, 18, 19 i 20 i kosztuje 9 € za wersję Odoo, płatność jednorazowa, netto (bez VAT). Szczegóły znajdziesz na stronie modułu i w karcie Odoo Apps; żeby zrozumieć, przez co przechodzi każdy rekord od środka, przeczytaj jak działa moduł.

Czytaj dalej