gitwtfhub

wtf is reformock?

bedis-elacheche/reformock — explained in plain English

Analysis updated 2026-05-18

4TypeScriptAudience · developerComplexity · 3/5Setup · easy

TL;DR

A Docker mock server that simulates France's e-invoicing partner platform API for testing integrations.

Mindmap

mindmap
  root((reformock))
    What it does
      Mock e-invoicing PDP
      Fake invoice generation
      Standard API routes
    Tech stack
      Node.js
      Docker
      OAuth2
    Use cases
      Test e-invoicing integration
      Upload real invoices
      Simulate invoice volume
    Audience
      French developers

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

Why would anyone build with this?

REASON 1

Test a software integration against France's AFNOR XP Z12-013 e-invoicing API without a real test environment.

REASON 2

Upload real invoice files through a web console to see how they surface through the standard API.

REASON 3

Generate batches of fake invoices on demand to test how an integration handles high volume.

What's in the stack?

TypeScriptNode.jsDockerOAuth2

How it stacks up

bedis-elacheche/reformock0labs-in/vision-linkadarsh-me/image-sdk
Stars444
LanguageTypeScriptTypeScriptTypeScript
Setup difficultyeasymoderateeasy
Complexity3/53/52/5
Audiencedeveloperdeveloperdeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you spin it up?

Difficulty · easy Time to first run · 5min

Requires Docker, assumes familiarity with the French AFNOR XP Z12-013 e-invoicing standard.

Wtf does this do

Reformock is a Docker-based mock server that simulates a specific piece of French government infrastructure related to electronic invoicing. France is rolling out a mandatory e-invoicing reform, and businesses need to connect their software to certified intermediary platforms, called PDPs, that follow a technical standard known as AFNOR XP Z12-013. Testing that connection normally requires access to a real test environment, which is not always available. Reformock stands in for that missing environment by imitating the required API so developers can build and test their integration against something realistic. The mock server automatically generates fake invoices in the standard formats the norm expects, along with realistic lifecycle status updates, and serves them through the exact routes the official standard requires, such as checking service health, submitting a flow, searching for flows, retrieving a flow's details, and managing webhook subscriptions. It also includes extra, non-standard admin routes for controlling the mock itself: forcing a specific invoice status, generating a batch of fake invoices on demand, or clearing everything out of memory. A browser-based console lets you drag and drop your own invoice files, in formats like UBL XML or Factur-X PDF, and the mock will read them, extract details like invoice number and amounts, and make them available through the same API your integration will query. Everything uploaded through this console only lives in memory and disappears when the container restarts. The API requires standard OAuth2 authentication, though this can be disabled for simpler local testing, and there is also a way to obtain a token for scripted testing. This tool is aimed squarely at developers and companies in France who are building or testing software that must connect to the new e-invoicing partner platforms, and it assumes familiarity with that specific regulatory context. It is distributed as a ready-to-run Docker image, with tagged versions available for pinning to a stable release in a CI pipeline.

Yoink these prompts

Prompt 1
Show me how to run the reformock Docker image and get an OAuth2 token to call its API.
Prompt 2
Help me use the /v1/flows/search endpoint to fetch supplier invoices updated after a given date.
Prompt 3
Explain how to upload my own UBL invoice file through reformock's web console.
Prompt 4
Walk me through pinning a specific reformock Docker image version for a CI pipeline.

Frequently asked questions

wtf is reformock?

A Docker mock server that simulates France's e-invoicing partner platform API for testing integrations.

What language is reformock written in?

Mainly TypeScript. The stack also includes TypeScript, Node.js, Docker.

How hard is reformock to set up?

Setup difficulty is rated easy, with roughly 5min to a first successful run.

Who is reformock for?

Mainly developer.

View the repo → Decode another repo

This repo across BitVibe Labs

Don't trust strangers blindly. Verify against the repo.