Connecting Smaregi with ReceiptRoller lets transactions issued at Smaregi POS registers flow into ReceiptRoller automatically, so you can use them for digital receipt issuance, CRM integration, and sales analysis. The connection is completed by installing the app from the Smaregi App Market and then performing a one-click operation on the ReceiptRoller side.

What you need

• A Smaregi business account (a paid plan that supports API integration)
• Permission to log in to the Smaregi admin screen
• ReceiptRoller Basic plan or higher (Basic covers up to 1 POS terminal, Starter up to 3, and higher tiers for more)

The plan limit is counted by the "number of connected POS terminals (registers)." If a single store has multiple registers and you connect all of them, you'll need a plan that covers that many terminals.

Step 1: Install "ReceiptRoller Link" from the Smaregi App Market

1. Log in to the Smaregi admin screen.
2. Search for "ReceiptRoller Link" in the App Market and install it.
3. On the terms-of-use and access-permission screen shown during installation, select "Allow."

Step 2: Log in to ReceiptRoller from Smaregi

1. Click the "ReceiptRoller Link" icon from the app list on the Smaregi admin screen.
2. The ReceiptRoller login screen opens. Click the "Log in with Smaregi" button to sign in directly with your Smaregi account.
3. If this is your first time logging in, a ReceiptRoller account is created automatically using the email address registered in Smaregi.
4. After logging in, a list of business accounts is displayed. Select the business account and store to connect (if you haven't created one yet, create a new one).

Step 3: Connect as a POS terminal

1. Open "POS Terminals" from the store page you're connecting to.
2. Click the "Connect with Smaregi" button (the red button) in the upper right.
3. A list of stores on the Smaregi side is displayed. Select the store to connect.
   • If only one store is registered in Smaregi, the store selection step is skipped and you proceed directly to the next step.
4. A list of terminals (registers) within the selected store is displayed. Select the terminal to connect.
   • If there is only one terminal, terminal selection is also skipped and the connection completes automatically.
5. A connection-complete notification is displayed, and a new terminal card is added to the POS terminal list.

Step 4: Check the transaction sync

After the connection is complete, new transactions are sent to ReceiptRoller automatically in real time (via a Smaregi webhook). If you want to import past transactions or fill in any gaps where webhooks didn't arrive, you can also sync manually.

1. Open the POS terminal's detail page.
2. Click the "Sync with Smaregi" button (the red button) in the upper right.
3. The first sync retrieves transaction data from the past 30 days. From the second sync onward, only the differences since the previous sync are imported.
4. After the sync completes, the number of imported transactions is shown in the transaction list.

Data synced after connecting

Once connected, the following data flows automatically between Smaregi and ReceiptRoller.

Importing the product master (optional)

Transaction data begins syncing automatically as soon as the POS connection is complete, but importing the product master (the list of product names, SKUs, categories, prices, cost, etc.) is optional and up to the store operator. Import it if you want to enter cost prices on the ReceiptRoller side for profit analysis, or if you want to manage additional product attributes (brand, supplier, JAN code, etc.).

1. Open "Product Management" on the store admin screen.
2. Click "Sync from Smaregi" from the menu (⋮ icon) in the upper right.
3. All products and categories are imported via the Smaregi Platform API, and new additions/updates are applied automatically.
4. Once the sync completes, the number of imported items is shown at the top of the screen.

For details on which fields are imported, field-level support, behavior during re-sync, and Smaregi-specific notes (such as why tax rate or JAN code might not be imported), see Mapping Between Smaregi Product Data and ReceiptRoller Product Data.

Even without importing the product master, per-product sales analysis and ABC analysis still work (product names and categories are aggregated automatically from transaction line items). Only import it if you need cost management or profit analysis.

Connecting multiple stores or multiple terminals

If you operate multiple stores or terminals in Smaregi, you need to connect each one individually on the ReceiptRoller side as well.

• To add another terminal in the same store, click the "Connect with Smaregi" button again. Terminals that are already connected are excluded from the list, and only unconnected terminals are shown.
• To connect a different store, open that store's POS Terminals page on the ReceiptRoller side and follow the same steps.
• The number of POS terminals you can connect depends on your plan. If you reach the limit, you'll automatically be directed to the plan-change screen.

Notes

• Smaregi's API integration is only available on paid plans. Please check your Smaregi contract details.
• If terminals are added or removed on the Smaregi side after connecting, run "Connect with Smaregi" again on the ReceiptRoller side to reflect the change.
• Real-time transaction import requires the webhook setting to be enabled on the Smaregi side. You can check this setting on the "ReceiptRoller Link" app's settings screen in Smaregi.
• For past receipts, refunds, or cancellation history, manually sync using the "Sync with Smaregi" button to reflect the latest status.
• If the product master or member information changes significantly on the Smaregi side, we recommend refreshing it with a manual sync.

Troubleshooting

• No "Connect with Smaregi" button → Log back in via Smaregi before returning to the POS Terminals page. The connection requires contract ID information, which is passed to ReceiptRoller at login.
• Transactions don't appear after connecting → Click "Sync with Smaregi" on the POS terminal's detail page. Real-time sync may have stopped.
• "Upgrade required" is displayed → You've reached your plan's POS terminal limit. Consider upgrading to a higher plan from the plan-change screen.
• Transactions from the wrong store/terminal appear, or don't appear → Check that the Smaregi store ID/terminal ID selected at connection time matches the register that actually issued the transaction. You can check and change this on the POS terminal's edit screen.
• The "Sync from Smaregi" button doesn't appear in Product Management → You may not have any POS-connected terminals yet. Complete the POS connection described above first.

Related articles

• Smaregi Integration — Overview and Getting Started
• Connecting with POS
• Square POS Integration Setup
• Digital Receipt History Management
• POS Integration Troubleshooting

For more detail

For details on how Smaregi's transaction, member, and product data map to ReceiptRoller's internal model, see the technical reference articles below. They cover field-by-field mapping tables, status/payment-method normalization, resolving line-item/customer/staff information, and handling of time zones and rounding.

• Mapping Between Smaregi Transaction Data and ReceiptRoller Transaction Data (for developers and operations staff)
• Mapping Between Smaregi Member Data and ReceiptRoller Customer Data (for developers and operations staff)
• Mapping Between Smaregi Product Data and ReceiptRoller Product Data (for developers and operations staff)