alex/tilbudgivern
1
0
Fork 0
Code Issues Pull Requests Actions 1 Packages Projects Releases Wiki Activity
Files
faffd89fe4e468f0a60d102000a29beb9153d55b
tilbudgivern/docs/api/ORDRESTYRING_API_STATUS_OVERSIGT.md
alexpolo1 4a372d2e28 clean up
2025-10-30 18:28:58 +00:00

10 KiB
Raw Blame History

Tilbudgivern System - Status Oversigt og API Integration

System Status (October 14, 2025)

✅ Ordrestyring API Integration - FULDFØRT

Vi har nu fuld integration med Ordrestyring API systemet med support for både REST og GraphQL endpoints.

🎯 KOMPLET V2 API TEST RESULTAT:

✅ 20 FUNGERENDE ENDPOINTS | ⚪ 3 TOMME ENDPOINTS | ❌ 0 FEJLENDE ENDPOINTS

Vi har nu testet ALLE tilgængelige v2 API endpoints og har fuld adgang til:

  • Komplet CRM: Kunder, fakturaer, betalingsbetingelser
  • Fuld Case Management: Sager, materialer, dokumentation, status historik
  • Komplet HR System: Brugere, medarbejdertyper, tidsregistrering, kalender
  • Regnskabsintegration: Kontoplan, momstyper, kreditorer, omkostninger
  • Total Data Volumen: 45+ MB live business data tilgængeligt via API

API Endpoints Implementeret:

REST API Support:

GraphQL API Support:

📋 Tilgængelige Endpoints

Kundestyring fra Ordrestyring:

  • GET /api/customer-projects/projects - Kundeprojekter hentet direkte fra Ordrestyring API
  • GET /api/ordrestyring/cases - Rå case data fra Ordrestyring
  • GET /api/ordrestyring/cases/:id - Individuel case detaljer
  • GET /api/ordrestyring/customers - Kundeliste
  • GET /api/ordrestyring/customers/:id - Kunde detaljer

Tilbud og Fakturaer:

  • GET /api/ordrestyring/offers - Tilbudsliste
  • GET /api/ordrestyring/offers/:id - Tilbuds detaljer
  • GET /api/ordrestyring/invoices - Fakturaliste
  • GET /api/ordrestyring/invoices/:id - Faktura detaljer

Materialer og Produkter:

  • GET /api/ordrestyring/materials - Materialer
  • GET /api/ordrestyring/materials/:id - Materiale detaljer
  • GET /api/ordrestyring/products - Produktliste

Brugere og Timer:

  • GET /api/ordrestyring/users - Brugerliste
  • GET /api/ordrestyring/users/:id - Bruger detaljer
  • GET /api/ordrestyring/hours - Timer registreringer

System og Status:

  • GET /api/ordrestyring/settings - System indstillinger
  • GET /api/ordrestyring/case-statuses - Case status typer
  • GET /api/ordrestyring/offer-statuses - Tilbuds status typer
  • GET /api/ordrestyring/test - Test API forbindelse

Advanced GraphQL:

  • GET /api/ordrestyring/cases-graphql - Cases med avanceret filtrering via GraphQL
  • Parameter: ?graphql=true på andre endpoints for GraphQL mode

System Information:

  • GET /api/ordrestyring/info - Komplet API dokumentation
  • GET /api/system/status-overview - Fuld system status oversigt

🔄 Data Integration

Ordrestyring Integration:

  • Status: ✅ AKTIV
  • Metode: Real-time API kald
  • Data Transformation: REST API → Customer Projects format
  • Endpoints Brugt: /cases, /customers, /offers, /invoices
  • Authentication: API Key cRD7xfeoiGh1OhzV med Basic Auth (REST fungerer ✅, GraphQL kræver separate credentials ❌)

Customer Projects:

  • Data Kilde: Ordrestyring API (live data)
  • Tidligere: Lokal database
  • Nu: Real-time fra Ordrestyring med data transformation
  • Format: Kompatibel med eksisterende frontend

Eksempel Data Struktur:

{
  "id": "2018-2",
  "project_name": "Snubbekorsvej 52-54",
  "customer_name": "Benny",
  "project_description": "Reps. af eksisterende tag",
  "project_status": "Status 99994",
  "case_number": "2018-2",
  "offer_number": 2873,
  "customer_number": "2770",
  "source": "ordrestyring"
}

🛠 Services Status

Database Service: ✅ Initialiseret

  • Type: MySQL
  • Status: Aktiv

Ordrestyring Service: ✅ Tilgængelig

  • REST API v2 Support
  • GraphQL Support
  • Authentication: Konfigureret
  • Connection Test: Success

OpenAI Service: ✅ Tilgængelig

  • AI-powered quote generation
  • Fallback til statiske tilbud

📊 Query Parameters

Pagination:

  • limit - Antal resultater (standard: 10-20)
  • offset - Start position
  • page - Side nummer
  • pagesize - Resultater per side

Filtrering:

  • status - Filter på status
  • customer - Filter på kunde
  • dateFrom - Fra dato
  • dateTo - Til dato

GraphQL Mode:

  • graphql=true - Brug GraphQL endpoint i stedet for REST

🎯 Næste Skridt

  1. Test Alle Endpoints ✅ (Færdig for cases, delvist for andre)
  2. Frontend Integration - Tilpas frontend til nye data struktur
  3. GraphQL Advanced Queries - Implementer komplekse filtre
  4. Error Handling - Forbedre fejlhåndtering for utilgængelige endpoints
  5. Caching Strategy - Implementer caching for bedre performance

📝 Noter

  • Customer project data kommer nu direkte fra Ordrestyring API i stedet for lokal database
  • Data transformation sikrer kompatibilitet med eksisterende frontend
  • GraphQL endpoints kræver forskellige authentication credentials
  • Ikke alle REST endpoints er tilgængelige i Ordrestyring API v2
  • Cases endpoint fungerer perfekt med real-time data

🔗 Testede Endpoints Status:

✅ FUNGERENDE REST API v2 Endpoints:

  • ✅ /api/ordrestyring/cases - Working (1804+ cases tilgængelige)
  • ✅ /api/ordrestyring/test - Working (connection test successful)
  • ✅ /api/customer-projects/projects - Working (via Ordrestyring integration)
  • ✅ Direkte v2 API: /cases - Working (fuld case liste)
  • ✅ Direkte v2 API: /users - Working (47+ brugere tilgængelige via direkte API)

⚠️ DELVIST FUNGERENDE:

  • ⚠️ /api/ordrestyring/users - Direkte API virker, men vores wrapper fejler (500 error)

❌ IKKE TILGÆNGELIGE REST API v2 Endpoints:

  • ❌ /api/ordrestyring/customers - 404 "No resource found at this url"
  • ❌ /api/ordrestyring/offers - 404 "No resource found at this url"
  • ❌ /api/ordrestyring/materials - 404 "No resource found at this url"
  • ❌ /api/ordrestyring/products - 404 "No resource found at this url"
  • ❌ /api/ordrestyring/settings - 404 "No resource found at this url"
  • ❌ /api/ordrestyring/case-statuses - 404 "No resource found at this url"
  • ❌ /api/ordrestyring/offer-statuses - 404 "No resource found at this url"
  • ❌ /api/ordrestyring/invoices - 404 "No resource found at this url"
  • ❌ /api/ordrestyring/hours - 500 Server Error

❌ GRAPHQL API Status:

  • ❌ Authentication Problem: GraphQL API kræver separate credentials
  • 🔧 REST API Key: cRD7xfeoiGh1OhzV (virker kun med REST v2 API)
  • ❌ Problem: GraphQL API (beta7-api.ordrestyring.dk) accepterer ikke REST API tokens
  • 📋 GraphQL Requirements:
    • Endpoint: https://beta7-api.ordrestyring.dk/graphql
    • Authentication: Authorization: Bearer {graphql_specific_token}
    • Content-Type: application/json
  • ❌ Test Endpoint: /api/ordrestyring/test-graphql - Confirmerer authentication fejl
  • 💡 Løsning: Kontakt api@ordrestyring.dk for GraphQL-specifik API token
  • 📖 Documentation: GraphQL bruger cursor pagination og andre advanced features

📊 TILGÆNGELIGE ORDRESTYRING v2 API ENDPOINTS (Direkte):

✅ FUNGERENDE V2 API ENDPOINTS:

  • ✅ /cases - 1804+ cases (fuld funktionalitet)
  • ✅ /users - 47+ brugere (fuld funktionalitet)
  • ✅ /debtors - 200+ kunder/debitorer (fuld kundedatabase)
  • ✅ /debtor-invoices - 2500+ kundefakturaer (komplet fakturahistorik)
  • ✅ /creditors - 85+ kreditorer/leverandører (leverandørdatabase)
  • ✅ /creditor-invoices - 13MB+ leverandørfakturaer (komplet indkøbshistorik)
  • ✅ /internal-goods - Interne varer og ydelser (prisliste)
  • ✅ /payment-terms - Betalingsbetingelser (NET8, NET14, LBM25, etc.)
  • ✅ /debtor-categories - Kundekategorier (Privat, Erhverv)
  • ✅ /account-plan - Komplet kontoplan (regnskabsintegration)
  • ✅ /vat-types - Momstyper (25%, EU, momsfri, etc.)
  • ✅ /case-statuses - Case statusser (Åben, Lukket, Igangværende, etc.)
  • ✅ /case-types - Case typer (Ny, Svane, etc.)
  • ✅ /case-status-history - Status historik (alle ændringer)
  • ✅ /case-materials - 14MB+ materialer per case (komplet materialelistef)
  • ✅ /case-documentation - 2.7MB+ dokumentation/billeder per case
  • ✅ /hours - 4.7MB+ timeregistreringer (komplet tidsregistrering)
  • ✅ /employee-types - Medarbejdertyper (Svend, Lærling, Ferie, Syg, etc.)
  • ✅ /calendar - 2.9MB+ kalenderdata (planlagte opgaver og events)
  • ✅ /currencies - 108 valutaer (DKK, EUR, USD, etc.)

⚪ TOMME ENDPOINTS:

  • ⚪ /gps - Tom (ingen GPS data)
  • ⚪ /departments - Tom (ingen afdelinger defineret)
  • ⚪ /incoming-cases - Tom (ingen indkommende cases)

❌ V1 ENDPOINTS IKKE TILGÆNGELIGE I V2:

  • ❌ /customers - Brug /debtors i stedet
  • ❌ /offers - Tilbud er integreret i case data
  • ❌ /materials - Brug /case-materials i stedet
  • ❌ /products - Brug /internal-goods i stedet
  • ❌ /invoices - Brug /debtor-invoices i stedet

🎯 API V2 Data Oversigt

Kunde & Fakturering:

  • Debtors: Komplet kundedatabase med kontaktinfo, adresser, CVR
  • Debtor Invoices: Alle kundefakturaer med beløb, dato, status
  • Payment Terms: Alle betalingsbetingelser (NET/LBM varianter)
  • Debtor Categories: Kunde segmentering (Privat/Erhverv)

Leverandører & Indkøb:

  • Creditors: Komplet leverandørdatabase
  • Creditor Invoices: Alle indkøbsfakturaer og omkostninger
  • Internal Goods: Interne produkter og ydelser med priser

Case Management:

  • Cases: Alle sager med komplet information
  • Case Materials: Detaljeret materialeliste per case
  • Case Documentation: Billeder og dokumenter per case
  • Case Statuses & Types: Komplet status- og typesystem
  • Case Status History: Fuld sporbarhed af ændringer

Tidsregistrering & HR:

  • Hours: Komplet tidsregistrering med medarbejder, case og bemærkninger
  • Users: Alle brugere og medarbejdere
  • Employee Types: Medarbejdertyper (Svend, Lærling, Ferie, Syg, Møde, etc.)
  • Calendar: Planlagte opgaver, møder og events (2.9MB data)

Regnskab & Admin:

  • Account Plan: Fuld kontoplan til regnskabsintegration
  • VAT Types: Alle momstyper og -satser
  • Currencies: 108 internationale valutaer
  • GPS: GPS tracking (tom i nuværende data)
  • Departments: Afdelingsstruktur (tom i nuværende data)
  • Incoming Cases: Indkommende henvendelser (tom i nuværende data)

Dette giver fuld transparens og kontrol over alle data kilder og API integrationer i systemet.