hexagone-swdoc

What this skill does

# Hexagone Web Services Documentation -- Navigation Skill

This skill gives you access to the **Hexagone Web Services documentation** ("Référence Appels Externes") published as GitLab Pages. Your role is to **fetch and read the relevant pages** when answering questions about Hexagone web services, not to rely on memorized knowledge.

## What is Hexagone swdoc

The Hexagone "Appels Externes" module (EW) exposes SOAP web services that allow external applications to invoke Hexagone Web business logic. The documentation is organized by **service module** (EWPT0001, EWPT0002, etc.), each grouping methods for a specific healthcare domain.

The documentation is published at:

```
https://erp-pas.gitlab-pages-erp-pas.dedalus.lan/hexagone/swdoc/
```

**When to use this skill:**
- The user asks about a Hexagone web service, SOAP method, or EWPT service
- The user needs to understand how to call a specific Hexagone API method
- The user is integrating with Hexagone and needs the service contract (parameters, DTDs)
- The user asks about XML DTD formats (CASE.HEXASERV, PATIENT_INFO.HEXASERV, etc.)
- The user wants to know which methods are available for a given domain (patients, movements, emergencies, etc.)
- The user is debugging an integration issue (error codes, statuts, configuration)
- The user asks about Hexagone API error codes or error handling (RESULT.HEXACALLW)
- Any question mentioning "Hexagone" combined with "web service", "API", "EWPT", "appels externes", "service web", or "WS"

## Service catalog

The base URL for all pages is:

```
BASE_URL = https://erp-pas.gitlab-pages-erp-pas.dedalus.lan/hexagone/swdoc/
```

### Complete service index

| Service | Domain | URL path | Key methods |
|---------|--------|----------|-------------|
| Introduction | General (auth, errors, data exchange) | `00-introduction/` | — |
| **EWPT0001** | Gestion des patients | `01-ewpt0001-gestion-des-patients/` | READ_PATIENT, FIND_PATIENT, NEW_PATIENT, UPDATE_PATIENT, READ_COVERAGES, READ_KINS, READ_DOCTOR, READ_CHILDLINK, CREATE_CHILDLINK, UPDATE_CHILDLINK, DELETE_CHILDLINK, SET_NEWBORN_STATE, ASSIGN_PROT_PATIENT, UPDATE_PROT_PATIENT, READ_PROT_PATIENT, PATIENT_DEBT, READ_PATIENT_ADDR, NEW_PATIENT_ADDR, UPDATE_PATIENT_ADDR, DELETE_PATIENT_ADDR, LEGAL_REPRESENTATIVES, REQUEST_PATIENT_MERGE, REQUEST_PATIENT_MERGE2, READ_PATIENT_DEMAT |
| **EWPT0002** | Gestion des urgences | `02-ewpt0002-gestion-des-urgences/` | READ_EMERGENCY, NEW_EMERGENCY, UPDATE_EMERGENCY, ENDOF_EMERGENCY, CANCEL_ENDOF_EMERGENCY, TO_OUTPATIENT, TO_INPATIENT, DELETE_EMERGENCY |
| **EWPT0003** | Consultations externes | `03-ewpt0003-gestion-des-consultations-externes/` | NEW_OUTPATIENT, READ_OUTPATIENT, UPDATE_OUTPATIENT, DELETE_OUTPATIENT |
| **EWPT0004** | Dossiers d'hospitalisation | `04-ewpt0004-gestion-des-dossiers-d-hospitalisation/` | READ_INPATIENT, NEW_INPATIENT, UPDATE_INPATIENT, DELETE_INPATIENT, CONFIRM_PREADMIT, READ_MOVEMENT, NEW_MOVEMENT, UPDATE_MOVEMENT, DELETE_MOVEMENT, CREATE_PENDING_VISIT_MVTS, MOVEMENT_AT, HOSP_BABY |
| **EWPT0005** | Lecture des occupations | `05-ewpt0005-lecture-des-occupations/` | ACTIVE_EMERGENCIES, HOUSING_UF_OCC, UF_OCC, RESPCENTER_OCC, SERVICE_OCC, POLE_OCC, LOCALIZATION_OCC, AVAILABLE_BEDS, IN_HOSPITAL |
| **EWPT0007** | Gestion des séjours | `07-ewpt0007-gestion-des-sejours/` | PATIENT_CASES, CASE_MVTS, MVT_HIST, HOSP_MODE_AT, NEW_HOSP_MODE, UPDATE_HOSP_MODE, DELETE_HOSP_MODE, READ_INFORMED_CONSENT, CHG_CASE_TYPE |
| **EWPT0008** | Produits | `08-ewpt0008-produits/` | INIT_ENV, GET_GEST, GET_FAMILY, GET_UNIT, GET_TAXE, GET_ACCOUNT_NUMBER, GET_UFMAINSTORE, GET_CMP, GET_GROUPING, PRODUCT_VERIFICATION, GET_PRODUCT_NUMBER, PRODUCT_CREATION |
| **EWPT0009** | Gestion du DMP | `09-ewpt0009-gestion-du-dmp/` | NEW_REJECTION, UPDATE_REJECTION, ACCESS_CODE, INFO_VITALE, READ_OTP, UPDATE_DMPINFO |
| **EWPT0010** | Gestion des praticiens | `10-ewpt0010-gestion-des-praticiens/` | FIND_PRACT, NEW_PRACT, UPDATE_PRACT |
| **EWPT0014** | Structures physiques | `14-ewpt0014-gestion-des-structures/` | CHACC_LOCALIZATION, FIND/READ/NEW/UPDATE/DELETE_BUILDING, FIND/READ/NEW/UPDATE/DELETE_FLOOR, FIND/READ/NEW/UPDATE/DELETE_BEDROOM, FIND/READ/NEW/UPDATE/DELETE_BED, FIND/READ/NEW/UPDATE/DELETE_LOCALIZATION |
| **EWPT0012** | Intégration d'actes | `12-ewpt0012-integration-d-actes/` | INTEGR_CCAM |
| **EWPT0013** | Re-génération Identités/mouvements | `13-ewpt0013-re-generation-identites-mouvements/` | REGEN_IDMVT |

### Method-to-service quick lookup

Use this table to quickly find which page to fetch when the user mentions a method name:

| Method pattern | Service page |
|----------------|-------------|
| `*_PATIENT*`, `*_CHILDLINK*`, `*_KIN*`, `*_COVERAGE*`, `*_DOCTOR*`, `PATIENT_DEBT`, `*_PROT_*`, `*_PATIENT_ADDR*`, `*_PATIENT_MERGE*`, `*_PATIENT_DEMAT*`, `LEGAL_REPRESENTATIVES` | EWPT0001 |
| `*_EMERGENCY*`, `TO_OUTPATIENT`, `TO_INPATIENT` | EWPT0002 |
| `*_OUTPATIENT*` | EWPT0003 |
| `*_INPATIENT*`, `*_MOVEMENT*`, `CONFIRM_PREADMIT`, `CREATE_PENDING_VISIT_MVTS`, `MOVEMENT_AT`, `HOSP_BABY` | EWPT0004 |
| `*_OCC`, `ACTIVE_EMERGENCIES`, `AVAILABLE_BEDS`, `IN_HOSPITAL` | EWPT0005 |
| `PATIENT_CASES`, `CASE_MVTS`, `MVT_HIST`, `*_HOSP_MODE*`, `READ_INFORMED_CONSENT`, `CHG_CASE_TYPE` | EWPT0007 |
| `INIT_ENV`, `GET_*`, `PRODUCT_*` | EWPT0008 |
| `*_REJECTION`, `ACCESS_CODE`, `INFO_VITALE`, `READ_OTP`, `UPDATE_DMPINFO` | EWPT0009 |
| `*_PRACT*` | EWPT0010 |
| `*_BUILDING*`, `*_FLOOR*`, `*_BEDROOM*`, `*_BED*`, `*_LOCALIZATION*`, `CHACC_LOCALIZATION` | EWPT0014 |
| `INTEGR_CCAM` | EWPT0012 |
| `REGEN_IDMVT` | EWPT0013 |

### Key DTD formats

| DTD | Used by | Description |
|-----|---------|-------------|
| RESULT.HEXACALLW | All methods | Standard error/result envelope (code, status, descr, when) |
| PATIENT_INFO.HEXASERV | EWPT0001 | Patient demographic data |
| PATPROT.HEXASERV | EWPT0001 | Patient protection data |
| LIST_PAT.HEXASERV | EWPT0001 | Patient search results |
| CHILD_LINK.HEXASERV | EWPT0001 | Mother-child link |
| LIST_COVERAGE.HEXASERV | EWPT0001 | Patient coverage list |
| LIST_KIN.HEXASERV | EWPT0001 | Patient next-of-kin list |
| LIST_ADR.HEXASERV | EWPT0001 | Patient addresses |
| PAT_RMERGE.HEXASERV | EWPT0001 | Patient merge request |
| LIST_DOCPAT.HEXASERV | EWPT0001 | Dematerialized patient documents |
| CASE.HEXASERV | EWPT0002, EWPT0004 | Inpatient case/visit + movements |
| CX_CASE.HEXASERV | EWPT0003 | Outpatient (consultation) case |
| MVT_CASE.HEXASERV | EWPT0004 | Movement data within a case |
| LIST_OCC.HEXASERV | EWPT0005 | Occupation list (beds, units) |
| LIST_BED.HEXASERV | EWPT0005 | Available beds list |
| LIST_CASE.HEXASERV | EWPT0007 | Patient cases list |
| LIST_MVT.HEXASERV | EWPT0007 | Movements list for a case |
| MVT_HIST.HEXASERV | EWPT0007 | Movement history |
| HOSP_MODE.HEXAGHP | EWPT0007 | Hospitalization mode |
| INF_CONS.HEXASERV | EWPT0007 | Informed consent |
| LIST_PRACT.HEXAGHP | EWPT0010 | Practitioner list |
| DMP_*.HEXASERV | EWPT0009 | DMP-related DTDs |

## How to answer questions

### Step 1: Identify the relevant page

Map the user's question to one or more service pages using the tables above:

- **Specific method name** (e.g., "READ_PATIENT") → use the method-to-service lookup
- **Domain keyword** (e.g., "patient", "urgence", "hospitalisation") → match to the service catalog
- **DTD name** (e.g., "CASE.HEXASERV") → use the DTD table to find the service page
- **Error handling / general architecture** → fetch the Introduction page
- **General "list all services"** → use the catalog above, no fetch needed

### Step 2: Fetch the page

Use the WebFetch tool to retrieve the relevant page:

```
WebFetch: url="${BASE_URL}<page-path>" format="markdown"
```

For example:
- Introduction: `WebFetch: url="https://erp-pas.gitlab-pages-erp-pas.dedalus.lan/hexagone/swdoc/00-introduction/" format="markdown"`
- Patient management: `WebFetch: url="https://erp-pas.gitlab-pages-erp-pas.dedalus.lan/hexagone/swdoc/01-ewpt0001-gestion-des-pat