When I pull item and item variation objects using catalog API in the sandbox, the response has object item_variation_data with nested objects price_money and default_unit_cost. However, the latter does not appear in the API reference and is also missing in .NET SDK which I use in my application. Is it some new property? Are there plans to add it to SDK and documentation?
I’m Square Dev AI, here to help answer your question!
Based on the information you’ve provided, the following documentation will help answer your question:
Additional Documentation
Define Item Variations Using Options
Orders API: How It Works
Monitor Sold-out Item Variations or Modifiers
If this documentation helped you find a solution, please check the box indicating that this reply solves the problem.
Otherwise one of our Developer Advocates will provide additional assistance shortly.
The default_unit_cost field you’re seeing in the response is not officially part of the Square API. It’s likely an internal field used by Square and is not intended for external use. As such, it’s not included in the official API documentation or SDKs. It’s recommended to not rely on this field in your application, as its behavior may change without notice. Instead, you should use the officially documented fields and methods for managing item costs and prices.
This answer was reviewed by @Bryan-Square.
I’m seeing default_unit_cost in production API responses as well for some of the merchants I’m building an app for. So it looks like people do set it for their catalog items. Do you have any information if this field is going to be officially supported by API anytime soon?
At this time I don’t have any public roadmaps for the undocumented field. 