How to get started with Cropwise Services 🌾🔧

General Description

Cropwise Core Services provide a comprehensive suite of APIs for setting up and managing your digital farm environment. These services enable you to create and manage organizations, properties, and fields - the foundational elements of your agricultural operations. This guide will walk you through the essential steps to get started with the platform.

Table of Contents

1. Initial Setup
2. Create your Organization
3. Create your Property
4. Upload your Fields
5. Next Steps

Initial Setup 🔰

Note: This step covers Account, Workspace, and Contract setup.

Account

To begin using Cropwise Core Services, you must have an account. Your account serves as your identity within the platform and determines your access to features and services based on your permissions.

Workspace

A workspace is the primary organizational unit in Cropwise Core Services. It encapsulates all other entities and allows you to manage your digital farm efficiently. Each workspace can contain multiple organizations, properties, and fields, providing a flexible hierarchy for structuring your agricultural data.

Contract

Contracts connect workspaces to Apps, granting access to specific services and features. They are essential for managing permissions and ensuring you have the appropriate access according to your subscription level.

To set up your Account, Workspace, and Contracts, please contact our support team at cwopenplatform.support@syngenta.com.

Create Your Organization 🏢

Requirements: Initial Setup

Within your workspace, you can create multiple organizations. An organization represents a specific entity or business unit and allows you to manage resources, permissions, and data specific to that organization.

Organizations act as containers for properties and fields, establishing a clear hierarchy for your agricultural data. Each organization can represent different business units, farming operations, or client accounts, enabling effective resource management and separation.

API Reference: For details on creating and managing organizations programmatically, see Working with Organizations.

Create Your Property 🏘️

Requirements:

• Initial Setup
• Create Your Organization

Within each organization, you can create multiple properties. A property represents a specific piece of land or farming location. Properties serve as logical containers for fields and provide essential geographical and operational context for your agricultural activities.

Properties help you organize your land based on location, management practices, or ownership structure. Each property includes information such as location coordinates, address details, and time zone settings, which are vital for accurate planning and operations.

API Reference: For detailed information about creating and managing properties programmatically, see Managing Properties.

Upload your Fields 🌾

Requirements:

• Initial Setup
• Create your Organization
• Create your Property

Fields are digital representations of your farming areas within the Cropwise platform, combining geographic data and seasonal context. Fields are essential for precise agricultural management, enabling you to track crop growth stages.

You can create individual fields or upload multiple fields in batch operations to efficiently set up your digital farm environment.

API Reference: For detailed information about creating and managing fields programmatically, see the Fields API Reference.

Next Steps 🧭

Now that you have set up your digital farm environment with organizations, properties, and fields, you're ready to start leveraging the full capabilities of the Cropwise Core Services. Here are some suggested next steps:

1. Explore the API Reference Documentation: Dive deeper into Understanding Core Services APIs to understand all available endpoints and operations.

2. Review Best Practices: Learn how to optimize your integration with Cropwise Core Services by following our Integration Best Practices recommendations.

3. Start Building Your Application: Begin developing your custom application that leverages Cropwise Core Services for your specific agricultural needs.

For additional support or questions, please contact our support team at cwopenplatform.support@syngenta.com.