Manager.UUID - Handleiding
Overzicht van alle custom fields (veld-ID / UUID, naam en type) uit uw Manager.io-administratie, plus welke Manager.*-programma's welke veld-ID's gebruiken.
| Versie | Starten | Waar |
| Webversie (aanbevolen) | start-manager-uuid-web.bat | http://127.0.0.1:4445 |
| Consoleversie | start-manager-uuid-console.bat | in het opdrachtvenster |
Belangrijk: alleen lezen
Manager.UUID kan uw gegevens in Manager.io nooit wijzigen of verwijderen.
- Alle verbindingen met Manager.io zijn alleen-lezen (GET-aanvragen): het bedrijf ophalen om de sleutel te testen, en de vier overzichten van custom fields (tekst, getal, datum, aankruisvakje).
- Het programma bevat geen enkele schrijf-, wijzig- of verwijderopdracht naar de database.
- Het enige bestand dat op uw computer wordt weggeschreven is de lokale instelling
api_config.json (alleen de API-sleutel en het actieve bedrijf).
U kunt dus zonder risico op "Vernieuwen" klikken of de pagina verversen.
Veiligheid van de lokale server
- De webpagina draait op http://127.0.0.1:4445 - alleen op deze computer, niet bereikbaar vanaf het netwerk.
- De server accepteert alleen aanvragen met de juiste adresregel (
127.0.0.1:4445 of localhost:4445).
- Er wordt niets gelogd (ook de API-sleutel niet).
- De API-sleutel staat alleen in
api_config.json (staat in .gitignore, wordt dus nooit met git meegestuurd).
Vereisten
- Python 3 (geïnstalleerd op deze computer).
- Manager.io draait met de API actief op poort 55667. (Instellingen → API. "API actief voor bewerken" is niet nodig - alleen-lezen werkt met elke toegangssleutel die "Lezen" toestaat.)
- Alle Manager.*-programma's staan onder
C:\Manager\, bijvoorbeeld:
C:\Manager\Manager.UUID\ (dit programma)
C:\Manager\Manager.VAT\
C:\Manager\Manager.UBL\
C:\Manager\Manager.io\ (import/export-programma; de veld-ID's hierin zijn leidend, de servers moeten deze waarden gebruiken)
Configureren
Eerste keer - API-sleutel instellen
- Open Manager.io en haal een API-sleutel op: Instellingen → API → Access Tokens → Nieuw token.
- Kopieer de sleutel.
- Start de webversie (
start-manager-uuid-web.bat) en open http://127.0.0.1:4445.
- Klik op het tandwiel rechtsboven:
- Verbinding testen - controleert of de sleutel klopt.
- Opslaan - slaat de sleutel lokaal op in
api_config.json.
De sleutel kan ook handmatig in api_config.json worden gezet:
{
"active_business": "Naam van het bedrijf",
"businesses": {
"Naam van het bedrijf": "de-api-sleutel"
}
}
Meerdere bedrijven (administraties)
Heeft u meerdere bedrijven in Manager.io, dan kunt u voor elk bedrijf een sleutel opslaan. Er verschijnt dan een bedrijfskeuze boven in de pagina; het actieve bedrijf wordt onthouden in api_config.json. Elke administratie heeft eigen toegangstokens - maak per bedrijf een token aan in Instellingen → API → Access Tokens.
Gebruik
Webversie (http://127.0.0.1:4445)
De tabel toont per custom field:
| Kolom | Uitleg |
| UUID | Het unieke veld-ID (de waarde die de programma's gebruiken) |
| Naam | De naam zoals u die in Manager.io heeft gegeven |
| Type | tekst / getal / datum / aankruisvakje |
| Gebruikt door | Welk programma dit veld gebruikt (per gekozen programma) |
Bovenin:
- Programmakeuze - kies een programma (bijv.
Manager.VAT, Manager.UBL, Manager.io) om te zien welke veld-ID's dat programma gebruikt. Kies "— geen programma —" voor alleen de overzichten.
- Vernieuwen - haalt de gegevens opnieuw op uit Manager.io.
- Aantal - totaal aantal custom fields, en hoeveel daarvan door het gekozen programma worden gebruikt.
Waarschuwing: bevat een programma een veld-ID dat niet in Manager.io bestaat, dan verschijnt er een oranje melding met de betreffende ID's. De veld-ID's in het programma Manager.io zijn leidend; de servers moeten deze waarden gebruiken. Een afwijking is dan direct zichtbaar.
Consoleversie (start-manager-uuid-console.bat)
Toont dezelfde overzichten in het opdrachtvenster, inclusief een controle welke hardcoded veld-ID's in de programma's wel of niet bestaan als custom field. Sluiten: op Enter drukken of het venster sluiten.
Stoppen van de webversie
Sluit het zwarte opdrachtvenster van start-manager-uuid-web.bat, of druk er op Ctrl+C. De webpagina is dan niet meer bereikbaar.
Problemen oplossen
| Probleem | Oplossing |
| "Geen API-sleutel in api_config.json" | Tandwiel → sleutel invullen en opslaan |
| "API-sleutel ongeldig (401)" | Sleutel opnieuw aanmaken in Manager.io en opslaan |
| "Geen verbinding met Manager.io" | Start Manager.io en zet de API aan (poort 55667) |
| "Fout: poort 4445 is al in gebruik" | Er draait al een exemplaar; het venster van start-manager-uuid-web.bat sluiten |
| Lege tabel | Klik Vernieuwen; controleer of de API-sleutel geldig is |
Bestanden in deze map
| Bestand | Doel |
server_manager_uuid.py | Webversie op poort 4445 |
lockup-blue.png | Logo rechtsboven op de pagina en in de print |
uuids.py | Consoleversie |
common.py | Gedeelde velddefinities (web + console) |
field_scan.py | Zoekt veld-ID's in alle C:\Manager\Manager.*-programma's (recursief) |
start-manager-uuid-web.bat | Start de webversie |
start-manager-uuid-console.bat | Start de consoleversie |
api_config.json | Lokale instelling (API-sleutels per bedrijf) - niet in git |
.gitignore | Zorgt dat api_config.json buiten git blijft |
Manager.UUID - Manual
Overview of all custom fields (field ID / UUID, name and type) from your Manager.io administration, plus which Manager.* programs use which field IDs.
| Version | Start | Where |
| Web version (recommended) | start-manager-uuid-web.bat | http://127.0.0.1:4445 |
| Console version | start-manager-uuid-console.bat | in the command window |
Important: read-only
Manager.UUID can never change or delete your data in Manager.io.
- All connections to Manager.io are read-only (GET requests): fetching the business to test the key, and the four custom-field overviews (text, number, date, checkbox).
- The program contains no write, change or delete command to the database whatsoever.
- The only file written on your computer is the local setting
api_config.json (only the API key and the active business).
So you can click "Refresh" or reload the page without risk.
Security of the local server
- The web page runs at http://127.0.0.1:4445 - on this computer only, not reachable from the network.
- The server only accepts requests with the correct address line (
127.0.0.1:4445 or localhost:4445).
- Nothing is logged (not even the API key).
- The API key lives only in
api_config.json (in .gitignore, so it is never sent with git).
Requirements
- Python 3 (installed on this computer).
- Manager.io running with the API active on port 55667. (Settings → API. "API active for editing" is not needed - read-only works with any key that allows "Read".)
- All Manager.* programs under
C:\Manager\, for example:
C:\Manager\Manager.UUID\ (this program)
C:\Manager\Manager.VAT\
C:\Manager\Manager.UBL\
C:\Manager\Manager.io\ (import/export program; the field IDs in it are leading, the servers must use these values)
Configuring
First time - setting the API key
- Open Manager.io and fetch an API key: Settings → API → Access Tokens → New token.
- Copy the key.
- Start the web version (
start-manager-uuid-web.bat) and open http://127.0.0.1:4445.
- Click the gear at the top right:
- Test connection - checks whether the key is correct.
- Save - stores the key locally in
api_config.json.
The key can also be put manually in api_config.json:
{
"active_business": "Name of the business",
"businesses": {
"Name of the business": "the-api-key"
}
}
Multiple businesses (administrations)
If you have multiple businesses in Manager.io, you can store a key per business. A business choice then appears at the top of the page; the active business is remembered in api_config.json. Each administration has its own access tokens - create one token per business in Settings → API → Access Tokens.
Use
Web version (http://127.0.0.1:4445)
The table shows per custom field:
| Column | Explanation |
| UUID | The unique field ID (the value the programs use) |
| Name | The name as you gave it in Manager.io |
| Type | text / number / date / checkbox |
| Used by | Which program uses this field (per chosen program) |
At the top:
- Program choice - choose a program (e.g.
Manager.VAT, Manager.UBL, Manager.io) to see which field IDs that program uses. Choose "— no program —" for only the overviews.
- Refresh - fetches the data from Manager.io again.
- Count - total number of custom fields, and how many of them the chosen program uses.
Warning: if a program contains a field ID that does not exist in Manager.io, an orange message appears with those IDs. The field IDs in the program Manager.io are leading; the servers must use these values. A deviation is then directly visible.
Console version (start-manager-uuid-console.bat)
Shows the same overviews in the command window, including a check which hardcoded field IDs in the programs do or do not exist as a custom field. Closing: press Enter or close the window.
Stopping the web version
Close the black command window of start-manager-uuid-web.bat, or press Ctrl+C in it. The web page is then no longer reachable.
Troubleshooting
| Problem | Solution |
| "No API key in api_config.json" | Gear → fill in key and save |
| "API key invalid (401)" | Create the key again in Manager.io and save |
| "No connection to Manager.io" | Start Manager.io and switch the API on (port 55667) |
| "Error: port 4445 already in use" | An instance is already running; close the start-manager-uuid-web.bat window |
| Empty table | Click Refresh; check that the API key is valid |
Files in this folder
| File | Purpose |
server_manager_uuid.py | Web version on port 4445 |
lockup-blue.png | Logo at the top right of the page and in the print |
uuids.py | Console version |
common.py | Shared field definitions (web + console) |
field_scan.py | Finds field IDs in all C:\Manager\Manager.* programs (recursive) |
start-manager-uuid-web.bat | Starts the web version |
start-manager-uuid-console.bat | Starts the console version |
api_config.json | Local setting (API keys per business) - not in git |
.gitignore | Keeps api_config.json out of git |