--- title: "Create New Machine" method: POST path: "/v1/machines" tags: ["Machines"] --- # Create New Machine `POST /v1/machines` ## Request - Base URL: `https://example.com:443` - URL: `https://example.com:443/v1/machines` - Auth: none required - TypeScript: (a function with typed inputs; its response is checked against the schema) Creates a new machine entry with the provided details. ## Request body - MachineInfoUpdateModel - `ActorID` integer, nullable: The unique identifier of the actor associated with the machine. - `CountryID` integer, nullable: The identifier for the country where the machine is located. - `CurrencyID` integer, nullable: The identifier for the currency used by the machine. - `InstituteID` integer, nullable: The identifier for the institute associated with the machine. - `LocationID` integer, nullable: The identifier for the specific location of the machine. - `MachineGroupID` integer, nullable: The identifier for the machine group. - `MachineModelID` integer, nullable: The identifier for the model of the machine. - `MachineName` string, nullable: The name assigned to the machine. - `MachineNumber` string, nullable: The unique number assigned to the machine. - `MachineStatusBit` integer: The status bit representing the current state of the machine. - `LanguageID` unknown - `SalesSourceID` integer, nullable: The identifier for the sales source associated with the machine. - `MachineTypeID` 555001 | 555002 | 555003 | 555004 | 555005 | 555006 | 555007 | 555008 | 556017 | 556018 | 30000514 | 30000515 | 30000516 | 30000517 | 30000518 | 30000519 | 30000520 | 30000521 | 30000522 | 30000523 | 30000524 | 30000525 | 30000526 | 30000527 | 30000561 | 30000578 | 30000579 | 30000580 | 30000581 | 30000582 | 30000583 | 30000602 | 30000611 | 30000612 | 30000617 | 30000618 | 30000619 | 30000620 | 30000623 | 176649542 | 227707459 | 227707460 | 504059468 | 529079224 | 363311433 | 244797254 - `SerialNumber` string, nullable: The serial number of the machine. - `VPOSSerialNumber` string, nullable: The serial number of the VPOS device in the machine. - `DeviceSerialNumber` string, nullable: The serial number of the device in the machine. - `UseLocationFrom` integer, nullable: The source of the location information used by the machine. - `GeoCountry` integer, nullable: The geographic country where the machine is located. - `GeoState` string, nullable: The geographic state where the machine is located. - `GeoCity` string, nullable: The geographic city where the machine is located. - `GeoAddress` string, nullable: The geographic address where the machine is located. - `GeoStreetNumber` string, nullable: The street number for the geographic location of the machine. - `GeoLongitude` number, double, nullable: The geographic longitude of the machine's location. - `GeoLatitude` number, double, nullable: The geographic latitude of the machine's location. - `GeoZoom` integer, nullable: The zoom level used for displaying the machine's location on a map. - `GeoZipCode` string, nullable: The ZIP code for the machine's geographic location. - `SearchAddress` string, nullable: The search address used for locating the machine. - `Remarks` string, nullable: Any remarks or notes associated with the machine. - `DexType` integer, nullable: The DEX type configuration of the machine. - `DexMidnightReadsEnableBit` boolean, nullable: Indicates if midnight reads are enabled for DEX. - `DexG85CheckEnableBit` boolean, nullable: Indicates if G85 checks are enabled for DEX. - `DexDivideBillsBy` integer, nullable: The value by which bills are divided for DEX. - `DexG85CheckParsingFilterEnableBit` boolean, nullable: Indicates if parsing filters for G85 checks are enabled. - `UseCardPriceCorrectCashPriceBit` boolean, nullable: Indicates if the card price is used to correct the cash price. - `MachineTimeZoneOffset` number, double, nullable: The time zone offset for the machine. - `DexReadInterval` integer, nullable: The interval for DEX reads in minutes. - `LocationType` integer, nullable: The type of location where the machine is placed. - `ApplyDisplayPickListSelectionsToReportsBit` boolean, nullable: Indicates if pick list selections should be applied to reports. - `DisplayPickListSelectionsAs` integer, nullable: The format in which pick list selections are displayed. - `MachineProfile` integer, nullable: The profile assigned to the machine. - `CityID` integer, nullable: The identifier for the city where the machine is located. - `RegionID` integer, nullable: The identifier for the region where the machine is located. - `CountryDialingCode` integer, nullable: The dialing code for the country where the machine is located. - `DexIgnoreCRCCheckBit` boolean, nullable: Indicates if CRC checks are ignored for DEX. - `DexParseLABit` boolean, nullable: Indicates if LA parsing is enabled for DEX. - `ProductMapID` integer, nullable: The identifier for the product map associated with the machine. - `Longitude` number, double, nullable: The longitude of the machine's location. - `Latitude` number, double, nullable: The latitude of the machine's location. - `DexTotalSalesMinusCardSalesBit` boolean, nullable: Indicates if total sales should exclude card sales in DEX. - `RouteActorID` integer, nullable: The identifier of the route actor managing the machine. - `MachineLogicAlertEnableBit` boolean, nullable: Indicates if machine logic alerts are enabled. - `AlertRuleSetId` integer, nullable: The identifier of the alert rule set associated with the machine. - `MachineMemberTypePricingEnableBit` boolean, nullable: Indicates if member type pricing is enabled for the machine. - `DexMultiplyCoinsBy` integer, nullable: The value by which DEX coins are multiplied. - `DexMultiplyTubesBy` integer, nullable: The value by which DEX tubes are multiplied. - `CustomerID` integer, nullable: The unique identifier of the customer associated with the machine. - `CommissionType` integer, nullable: The type of commission applied to the machine. - `CommissionDefaultValue` number, double, nullable: The default commission value applied to the machine. - `TubeSource` integer, nullable: The source of the tube data for the machine. - `BillSource` integer, nullable: The source of the bill data for the machine. - `SmartStickerId` integer, nullable: The identifier of the smart sticker associated with the machine. - `EnableRemoveVendBit` boolean, nullable: Indicates if the remove vend functionality is enabled. - `EnableEreceiptBit` boolean, nullable: Indicates if the e-receipt functionality is enabled. - `ProductMapAutomaticCreationBit` boolean, nullable: Indicates if the product map should be created automatically. ## Response `200` The machine was successfully created. - MachineInfo: Contains basic information about a machine, including identifiers, location details, and configuration settings. - `MachineID` integer, nullable: The unique identifier of the machine. - `ActorID` integer, nullable: The identifier of the actor associated with the machine. - `CountryID` integer, nullable: The identifier of the country where the machine is located. - `CurrencyID` integer, nullable: The identifier of the currency used by the machine. - `InstituteID` integer, nullable: The identifier of the institute associated with the machine. - `LocationID` integer, nullable: The identifier of the location where the machine is installed. - `MachineGroupID` integer, nullable: The identifier of the group to which the machine belongs. - `MachineModelID` integer, nullable: The identifier of the machine's model. - `MachineName` string, nullable: The name of the machine. - `MachineNumber` string, nullable: The serial number or unique identifier assigned to the machine by the manufacturer. - `MachineStatusBit` integer: A bit field indicating the status of the machine. - `LanguageID` unknown - `OperatorActorID` integer, nullable: The identifier of the operator managing the machine. - `DistributorActorID` integer, nullable: The identifier of the distributor associated with the machine. - `AreaActorID` integer, nullable: The identifier of the area actor responsible for the machine. - `SalesSourceID` integer, nullable: The identifier of the sales source associated with the machine. - `MachineTypeID` 555001 | 555002 | 555003 | 555004 | 555005 | 555006 | 555007 | 555008 | 556017 | 556018 | 30000514 | 30000515 | 30000516 | 30000517 | 30000518 | 30000519 | 30000520 | 30000521 | 30000522 | 30000523 | 30000524 | 30000525 | 30000526 | 30000527 | 30000561 | 30000578 | 30000579 | 30000580 | 30000581 | 30000582 | 30000583 | 30000602 | 30000611 | 30000612 | 30000617 | 30000618 | 30000619 | 30000620 | 30000623 | 176649542 | 227707459 | 227707460 | 504059468 | 529079224 | 363311433 | 244797254 - `SerialNumber` string, nullable: The serial number of the machine. - `VPOSSerialNumber` string, nullable: The VPOS serial number associated with the machine. - `DeviceSerialNumber` string, nullable: The serial number of the device installed in the machine. - `VPOSID` integer, nullable: The unique identifier of the VPOS device associated with the machine. - `DeviceID` integer, nullable: The unique identifier of the device installed in the machine. - `UseLocationFrom` integer, nullable: Specifies where the location information is sourced from. - `GeoCountry` integer, nullable: The country identifier based on geographic data. - `GeoState` string, nullable: The state or region based on geographic data. - `GeoCity` string, nullable: The city based on geographic data. - `GeoAddress` string, nullable: The full address based on geographic data. - `GeoStreetNumber` string, nullable: The street number based on geographic data. - `GeoLongitude` number, double, nullable: The geographic longitude where the machine is located. - `GeoLatitude` number, double, nullable: The geographic latitude where the machine is located. - `GeoZoom` integer, nullable: The zoom level for geographic data representation. - `GeoZipCode` string, nullable: The postal or ZIP code based on geographic data. - `SearchAddress` string, nullable: The address used for search purposes. - `Remarks` string, nullable: Additional remarks or notes about the machine. - `DexType` integer, nullable: The DEX type identifier. - `DexMidnightReadsEnableBit` boolean, nullable: Indicates if midnight DEX reads are enabled. - `DexG85CheckEnableBit` boolean, nullable: Indicates if the G85 check for DEX is enabled. - `DexDivideBillsBy` integer, nullable: The value by which DEX bills are divided. - `DexG85CheckParsingFilterEnableBit` boolean, nullable: Indicates if the parsing filter for DEX G85 check is enabled. - `UseCardPriceCorrectCashPriceBit` boolean, nullable: Indicates if card prices are used to correct cash prices. - `MachineTimeZoneOffset` number, double, nullable: The time zone offset for the machine. - `DexReadInterval` integer, nullable: The interval at which DEX reads occur. - `LocationType` integer, nullable: The identifier of the location type. - `ApplyDisplayPickListSelectionsToReportsBit` boolean, nullable: Indicates if picklist selections should be applied to reports. - `DisplayPickListSelectionsAs` integer, nullable: Specifies how picklist selections are displayed. - `LastUpdated` string, date-time, nullable: The date and time when the machine information was last updated. - `MachineProfile` integer, nullable: The identifier of the machine profile. - `CityID` integer, nullable: The identifier of the city where the machine is located. - `RegionID` integer, nullable: The identifier of the region where the machine is located. - `CountryDialingCode` integer, nullable: The dialing code for the country where the machine is located. - `DexIgnoreCRCCheckBit` boolean, nullable: Indicates if CRC checks are ignored in DEX. - `DexParseLABit` boolean, nullable: Indicates if the DEX LA parsing is enabled. - `ProductMapID` integer, nullable: The identifier of the product map associated with the machine. - `Longitude` number, double, nullable: The geographic longitude where the machine is located. - `Latitude` number, double, nullable: The geographic latitude where the machine is located. - `DexTotalSalesMinusCardSalesBit` boolean, nullable: Indicates if total sales should exclude card sales in DEX. - `RouteActorID` integer, nullable: The identifier of the route actor managing the machine. - `MachineLogicAlertEnableBit` boolean, nullable: Indicates if machine logic alerts are enabled. - `AlertRuleSetId` integer, nullable: The identifier of the alert rule set associated with the machine. - `MachineMemberTypePricingEnableBit` boolean, nullable: Indicates if member type pricing is enabled for the machine. - `DexMultiplyCoinsBy` integer, nullable: The value by which DEX coins are multiplied. - `DexMultiplyTubesBy` integer, nullable: The value by which DEX tubes are multiplied. - `CustomerID` integer, nullable: The unique identifier of the customer associated with the machine. - `CommissionType` integer, nullable: The type of commission applied to the machine. - `CommissionDefaultValue` number, double, nullable: The default commission value applied to the machine. - `CreatedBy` integer, nullable: The unique identifier of the user who created the machine entry. - `CreatedOn` string, date-time, nullable: The date and time when the machine entry was created. - `UpdateBy` integer, nullable: The unique identifier of the user who last updated the machine entry. - `TubeSource` integer, nullable: The source of the tube data for the machine. - `BillSource` integer, nullable: The source of the bill data for the machine. - `SmartStickerId` integer, nullable: The identifier of the smart sticker associated with the machine. - `EnableRemoveVendBit` boolean, nullable: Indicates if the remove vend functionality is enabled. - `EnableEreceiptBit` boolean, nullable: Indicates if the e-receipt functionality is enabled. - `ProductMapAutomaticCreationBit` boolean, nullable: Indicates if the product map is automatically created. - `Refs` object, nullable: Additional references associated with the machine. --- [API](https://skmtc.dev/nayax/apis/nayax-cortina-api.md) - [All operations](https://skmtc.dev/nayax/apis/nayax-cortina-api/llms.txt) - [OpenAPI document](https://skmtc.dev/nayax/apis/nayax-cortina-api/revisions/421f6f83c257?raw)