VulCode

Subiekt GT and nexo integration with your store and KSeF

Store orders arrive in Subiekt as documents, and stock and prices flow back to the store. Subiekt itself sends invoices to KSeF; we make sure the data they are built from is complete.

Invoicing and ERP
The Subiekt GT connector in the admin panel: an order's path through the store, the office connector, Sfera and Subiekt, the overnight order queue and the connector events

Which Subiekt, and which integration route

InsERT has two product lines. The version decides whether you can write your own extensions.

  1. Do you collect orders in BaseLinker, and does the standard flow do?

    Allegro and the store in one place, then order, document and stock, with no document rules of your own.

  2. Which InsERT product line?

    The version decides whether you can write your own extensions.

  3. Do you have Sfera for Subiekt GT?

    Subiekt GT Sfera, or the Sfera add-on for plain Subiekt GT.

Do you collect orders in BaseLinker, and does the standard flow do?
  • yesThe BaseLinker integratorBaseLinker
  • no
    Which InsERT product line?
    • Subiekt GT
      Do you have Sfera for Subiekt GT?
      • yes
        A connector via Sfera
      • no
        The Sfera add-on, then a connector
    • Subiekt nexo PRO
      A connector via Sfera for nexo

Where each part runs

The integration never touches Subiekt's database directly. It works through Sfera, the same rules the program uses. A sample layout for a cloud store and Subiekt in the office.

HTTPS, outboundSfera callsdocument savedonce the computer is on
Online store
orders API, stock and prices
Order queue
in the store while the office is silent
Connector
queue, event log, retries
Sfera
documents, customers, goods
Subiekt
the document and the KSeF invoice
The office computer is off
Orders wait in the queue and reach Subiekt once it is back.

Security

  • Outbound connections only

    The connector reaches out to your store, not the other way round. The program's database is never exposed to the internet.

  • API keys in the settings

    Store API keys in the connector settings, not in code.

  • A limited operator account

    A Subiekt operator account limited to the operations it needs.

What we sync

Subiekt is the source of truth for goods and stock; the store for online orders and customers.

The Stock and prices tab of the Subiekt GT connector: the source of truth, the store's warehouse and price list, the items with stock and price in Subiekt and in the store, and the variants of a file matched by code
  • A warehouse and price list set for the storeThe store shows stock from a specific warehouse and prices from a specific list. The choice must be explicit, not a default.
  • Stock after a document, price after a price list changeStock goes back to the store after every document in Subiekt, the price after a price list change. A periodic check catches anything that drifted.
  • A shared identifier, variants includedA code or EAN by which the store and Subiekt recognise the same product, variants included.

A ready connector or an integration via Sfera

If you sell through BaseLinker, the ready connection often suffices. We write code where your process goes beyond it.

A ready connector will do

BaseLinker's free integrator for Subiekt GT and nexo. We can help configure it.

BaseLinker

What you get

  1. Allegro and the store
  2. BaseLinker
  3. the BaseLinker integrator
  4. Subiekt GT or nexo

The standard flow: order, document, stock.

What it needs

  • Orders in BaseLinkerfrom Allegro and the store
  • No Sfera neededthe integrator is free

You need an integration via Sfera

A custom connector using Sfera, running next to Subiekt, with a queue and an event log.

What you get

  1. Your store or system
  2. a connector with a queue
  3. Sfera
  4. Subiekt

Documents by your rules: warehouses, price lists, discounts, kitting, plus data a ready connector does not carry.

What it needs

  • SferaSubiekt GT Sfera, the Sfera add-on, or Sfera for nexo
  • A computer or server in the officewith access to Subiekt, always on for high volume

On both routes: Sending to KSeF from the program uses InsPunkty. An empty wallet stops invoices even though the integration works.

What we settle before the first line of code

Most problems with Subiekt integrations come from settings, not code.

  1. Which Subiekt version do you have, and with Sfera?

    Why we ask

    Without Sfera there is no official route to write extensions for Subiekt GT. We check this first.

    Rollout step: Splitting roles

  2. Which warehouse and price list should the store use?

    Why we ask

    The store shows stock from a specific warehouse and prices from a specific list. The choice must be explicit, not a default.

    Rollout step: Product map

  3. Are there funds for KSeF in the InsERT Wallet?

    Why we ask

    Sending to KSeF from the program uses InsPunkty. An empty wallet stops invoices even though the integration works.

  4. How do the store and Subiekt recognise the same product?

    Why we ask

    A code or EAN by which the store and Subiekt recognise the same product, variants included.

    Rollout step: Product map

  5. How should discounts, delivery and packaging appear on the document?

    Why we ask

    Delivery and store discounts need their own document lines, or the totals will not match.

    Rollout step: The connector on a data copy

  6. Do business orders carry the tax number and full address?

    Why we ask

    A business order has to carry the tax number and full address, or the invoice fails validation.

    Rollout step: The connector on a data copy

An example rollout, not a case study: a custom store and Subiekt nexo PRO

  1. Splitting roles
    Allegro stays on the BaseLinker integrator and the store gets its own connector, so the same orders never take two routes.
    Question 1
  2. Product map
    We match products by code, check variants and set the store's price list.
    Questions 2, 4
  3. The connector on a data copy
    We build and test on a database copy, comparing documents with ones issued by hand.
    Questions 5, 6
  4. Launch and watch
    We switch on orders and stock, and for the first days compare stock in both systems.

Common questions about Subiekt integration

Answers about Sfera, KSeF and how the connector works.

Which Subiekt do you have, and where do you sell?

Tell us your Subiekt version, whether you have Sfera, and where orders come from. We will reply within an hour with questions and a quote.