punchout-troubleshooterlisted

# Punchout Troubleshooter Structured diagnosis for punchout catalog failures between procurement platforms (Coupa, Ariba, SAP, NetSuite, Workday) and supplier ecommerce sites. ## Inputs - Raw cXML PunchOutSetupRequest / PunchOutSetupResponse payloads, or OCI hook URL and return parameters - Symptom description (setup fails, catalog loads but cart does not return, wrong pricing, session drops) Sanitized example payloads for each failure class live in `references/payload_examples/`. ## Workflow 1. Classify the failure using the decision tree in `references/failure_taxonomy.md`: credential/auth (403, invalid Identity/SharedSecret), session (BuyerCookie mismatch, expired session), transport (TLS, redirect chain, POST vs GET), payload (malformed cXML, missing DTD, encoding), cart return (PunchOutOrderMessage schema, unit price vs extended price mismatch, UOM mapping). 2. Run `scripts/validate_cxml.py` against the payload to check schema conformance and flag the exact failing element. 3. Cross-check credentials domain conventions per platform in `references/platform_conventions.md` (NetworkID vs DUNS vs custom domain). 4. Produce a diagnosis: failing layer, exact evidence line from the payload, fix owner (buyer platform, supplier site, or network), and the test that confirms the fix. ## Output format `## Diagnosis` (one sentence), `## Evidence` (quoted payload lines), `## Fix` (owner plus change), `## Verification` (the POSTMAN or curl simulation that proves resolution). #