> ## Documentation Index
> Fetch the complete documentation index at: https://docs.nekt.com/llms.txt
> Use this file to discover all available pages before exploring further.
# AnyMarket as a data source
> Bring data from AnyMarket to Nekt.
AnyMarket is a leading e-commerce integration hub platform in Brazil that connects sellers to multiple marketplaces from a single platform. It enables businesses to manage products, inventory, orders, and shipments across various sales channels including Mercado Livre, Amazon, Shopee, Magalu, and many others.
## Configuring AnyMarket as a Source
In the [Sources](https://app.nekt.ai/sources) tab, click on the "Add source" button located on the top right of your screen. Then, select the AnyMarket option from the list of connectors.
Click **Next** and you'll be prompted to add your access.
### 1. Add account access
You'll need your AnyMarket API Token for this connection. You can generate or find this token in your AnyMarket account settings under API integrations.
The following configurations are available:
* **Token**: Your AnyMarket API authentication token. This is required to access your account data.
* **Start Date**: The earliest date from which records will be synced. Records created or updated after this date will be extracted from the source.
If no start date is provided, the connector will extract data from the past 120 days.
* **Lookback Window**: (Default: 30 days) The number of days to look back and refetch records based on the creation date. This helps ensure data completeness for recently modified records.
Once you're done, click **Next**.
### 2. Select streams
Choose which data streams you want to sync. AnyMarket provides comprehensive order data that includes marketplace information, buyer details, payments, items, and shipping information.
> Tip: The stream can be found more easily by typing its name.
Select the streams and click **Next**.
### 3. Configure data streams
Customize how you want your data to appear in your catalog. Select the desired layer where the data will be placed, a folder to organize it inside the layer, a name for each table (which will effectively contain the fetched data) and the type of sync.
* **Layer**: choose between the existing layers on your catalog. This is where you will find your new extracted tables as the extraction runs successfully.
* **Folder**: a folder can be created inside the selected layer to group all tables being created from this new data source.
* **Table name**: we suggest a name, but feel free to customize it. You have the option to add a **prefix** to all tables at once and make this process faster!
* **Sync Type**: you can choose between INCREMENTAL and FULL\_TABLE.
* Incremental: every time the extraction happens, we'll get only the new data - which is good if, for example, you want to keep every record ever fetched.
* Full table: every time the extraction happens, we'll get the current state of the data - which is good if, for example, you don't want to have deleted data in your catalog.
Once you are done configuring, click **Next**.
### 4. Configure data source
Describe your data source for easy identification within your organization, not exceeding 140 characters.
To define your [Trigger](https://docs.nekt.com/runs/scheduling-and-triggers), consider how often you want data to be extracted from this source. This decision usually depends on how frequently you need the new table data updated (every day, once a week, or only at specific times).
Optionally, you can define some additional settings:
* Configure Delta Log Retention and determine for how long we should store old states of this table as it gets updated. Read more about this resource [here](https://docs.nekt.com/get-started/core-concepts/resource-control).
* Determine when to execute an **Additional [Full Sync](https://docs.nekt.com/get-started/core-concepts/types-of-sync#additional-full-sync)**. This will complement the incremental data extractions, ensuring that your data is completely synchronized with your source every once in a while.
Once you are ready, click **Next** to finalize the setup.
### 5. Check your new source
You can view your new source on the [Sources](https://app.nekt.ai/sources) page. If needed, manually trigger the source extraction by clicking on the arrow button. Once executed, your data will appear in your Catalog.
For you to be able to see it on your [Catalog](https://app.nekt.ai/catalog), you need at least one successful source run.
# Streams and Fields
Below you'll find all available data streams from AnyMarket and their corresponding fields:
Stream containing comprehensive order data from all connected marketplaces.
**Key Fields:**
* `id` - Unique order identifier
* `accountName` - Account name
* `marketPlace` - Marketplace name (e.g., Mercado Livre, Amazon, Shopee)
* `marketPlaceId` - Marketplace identifier
* `marketPlaceNumber` - Marketplace order number
* `partnerId` - Partner identifier
* `subChannel` - Subchannel
* `subChannelNormalized` - Normalized subchannel
* `createdAt` - Order creation timestamp
* `lastUpdate` - Last update timestamp
* `status` - Order status
* `transmissionStatus` - Transmission status
* `marketPlaceStatus` - Marketplace order status
* `marketPlaceStatusComplement` - Marketplace status complement
* `deliveryStatus` - Delivery status
* `fulfillment` - Whether order is fulfilled
* `orderTypeName` - Order type name
**Financial Fields:**
* `discount` - Order discount
* `freight` - Freight cost
* `sellerFreight` - Freight cost for seller
* `interestValue` - Interest value
* `gross` - Gross value
* `total` - Total order value
**Cancellation Fields:**
* `cancelDate` - Date of cancellation
* `cancelDetails` - Cancellation details
* `cancellationCode` - Cancellation code
* `cancellationOrigin` - Cancellation origin
**Payment Fields:**
* `paymentDate` - Date of payment
* `documentPaymentInstitution` - Payment institution document
* `documentIntermediator` - Intermediator document
* `intermediateRegistrationId` - Intermediate registration ID
**Shipping & Logistics:**
* `shippingId` - Shipping identifier
* `shippingOptionId` - Shipping option identifier
* `logisticType` - Logistic type
* `marketPlaceShipmentStatus` - Marketplace shipment status
* `marketPlaceShipmentSubstatus` - Marketplace shipment substatus
* `printTagDate` - Print tag date
**URLs & Messages:**
* `marketPlaceUrl` - Marketplace URL
* `transmissionMessage` - Transmission message
**Nested Objects:**
**`invoice`** - Invoice details:
* `accessKey` - Invoice access key (NFe)
* `series` - Invoice series
* `number` - Invoice number
* `date` - Invoice date
* `cfop` - CFOP code
* `companyStateTaxId` - Company state tax ID
* `linkNfe` - NFe link
* `invoiceLink` - Invoice link
* `extraDescription` - Extra description
**`shipping`** - Shipping address:
* `address` - Full address
* `street` - Street name
* `number` - Street number
* `neighborhood` - Neighborhood
* `city` - City
* `state` - State
* `stateNameNormalized` - Normalized state name
* `country` - Country
* `countryAcronymNormalized` - Normalized country acronym
* `countryNameNormalized` - Normalized country name
* `zipCode` - ZIP code
* `comment` - Address comment
* `reference` - Address reference
* `receiverName` - Receiver name
* `promisedShippingTime` - Promised shipping time
* `promisedDispatchTime` - Promised dispatch time
**`billingAddress`** - Billing address:
* Same fields as `shipping` plus:
* `shipmentUserDocument` - User document
* `shipmentUserDocumentType` - Document type
* `shipmentUserName` - User name
**`anymarketAddress`** - AnyMarket normalized address:
* `address`, `street`, `number`, `neighborhood`
* `city`, `state`, `stateAcronymNormalized`
* `country`, `zipCode`, `comment`, `reference`
* `receiverName`, `promisedShippingTime`
**`buyer`** - Buyer information:
* `name` - Buyer name
* `email` - Email address
* `phone` - Phone number
* `cellPhone` - Cell phone number
* `document` - Document number
* `documentNumberNormalized` - Normalized document number
* `documentType` - Document type (CPF/CNPJ)
* `marketPlaceId` - Marketplace buyer ID
* `dateOfBirth` - Date of birth
* `companyStateTaxId` - Company state tax ID
**`payments`** - Payment information (array):
* `method` - Payment method
* `paymentMethodNormalized` - Normalized payment method
* `paymentDetailNormalized` - Normalized payment detail
* `status` - Payment status
* `value` - Payment value
* `installments` - Number of installments
* `marketplaceId` - Marketplace payment ID
* `gatewayFee` - Gateway fee
* `marketplaceFee` - Marketplace fee
* `documentPaymentInstitution` - Payment institution document
* `cardOperator` - Card operator
* `orderAuthorizationCardCode` - Card authorization code
**`items`** - Order items (array):
* `product` - Product details:
* `id` - Product ID
* `title` - Product title
* `externalIdProduct` - External product ID
* `sku` - SKU details:
* `id` - SKU ID
* `title` - SKU title
* `ean` - EAN code
* `partnerId` - Partner ID
* `externalId` - External SKU ID
* `amount` - Quantity
* `unit` - Unit price
* `gross` - Gross value
* `total` - Total value
* `discount` - Item discount
* `marketPlaceId` - Marketplace item ID
* `orderItemId` - Order item ID
* `idInMarketPlace` - ID in marketplace
* `officialStoreId` - Official store ID
* `officialStoreName` - Official store name
* `listingType` - Listing type
* `freeShipping` - Free shipping flag
* `isCatalog` - Catalog flag
* `idInMarketplaceCatalogOrigin` - Catalog origin ID
* `gatewayFee` - Gateway fee
* `marketplaceFee` - Marketplace fee
* `itemIdInMarketPlace` - Item ID in marketplace
* `shippings` - Item shipping methods (array):
* `id` - Shipping ID
* `shippingCarrierNormalized` - Normalized carrier
* `shippingCarrierTypeNormalized` - Normalized carrier type
* `shippingtype` - Shipping type
* `customization` - Customization details:
* `customizationType` - Type
* `customizationQuantity` - Quantity
* `customizationPrice` - Price
* `customizationValue` - Value
* `stocks` - Stock details (array):
* `amount` - Stock amount
* `stockLocalId` - Stock location ID
* `stockName` - Stock name
**`tracking`** - Tracking information:
* `carrier` - Carrier name
* `carrierDocument` - Carrier document
* `number` - Tracking number
* `url` - Tracking URL
* `date` - Tracking date
* `shippedDate` - Shipped date
* `estimateDate` - Estimated delivery date
* `deliveredDate` - Delivered date
* `bufferingDate` - Buffering date
**`pickup`** - Pickup details:
* `id` - Pickup ID
* `description` - Description
* `partnerId` - Partner ID
* `marketplaceId` - Marketplace ID
* `receiverName` - Receiver name
**`quoteReconciliation`** - Quote reconciliation:
* `quoteId` - Quote ID
* `price` - Quote price
**`metadata`** - Order metadata (array):
* `key` - Metadata key
* `value` - Metadata value
**`discountMetadata`** - Discount metadata (array):
* `type` - Discount types (array)
**Account Fields:**
* `idAccount` - Account ID
## Skills for agents
AnyMarket connector documentation as plain markdown, for use in AI agent contexts.